home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 9 / Night Owl CD-ROM (NOPV9) (Night Owl Publisher) (1993).ISO / 038a / riptm150.zip / RIPTERM.DOC < prev    next >
Text File  |  1993-02-16  |  164KB  |  3,655 lines
  1.      ┌──────────────────────────────────────────────────────────┐
  2.      │                                                          │░
  3.      │                 ───────────────────────                  │░
  4.      │                    RIPterm v1.50.00                      │░
  5.      │                 ───────────────────────                  │░
  6.      │                                                          │░
  7.      │                                                          │░
  8.      │                    February 16, 1993                     │░
  9.      │                                                          │░
  10.      │                                                          │░
  11.      │  Copyright (c) 1992-93, TeleGrafix Communications, Inc.  │░
  12.      │                   All Rights Reserved                    │░
  13.      │                                                          │░
  14.      └──────────────────────────────────────────────────────────┘░
  15.       ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  16.  
  17.  
  18. ┌────────────────────────────────────────────────────────────────────┐
  19. │                         1.0 ■ INTRODUCTION                         │
  20. └────────────────────────────────────────────────────────────────────┘
  21.  
  22. Thank you for trying RIPterm!  A revolutionary new way of viewing
  23. on-line hosts.  This graphics based terminal program is the latest
  24. release of the RIPscrip graphics system terminal program.
  25.  
  26. As a user of RIPterm, you should be aware of its licensing agreement.
  27. The following information details how, when and where RIPterm may be
  28. distributed.  Read this section very carefully.
  29.  
  30.  
  31. ┌────────────────────────────────────────────────────────────────────┐
  32. │                   1.1 ■ DISTRIBUTION INFORMATION                   │
  33. └────────────────────────────────────────────────────────────────────┘
  34.  
  35. You are free to distribute RIPterm to anyone you wish based upon the
  36. following terms and conditions.  RIPterm is FreeWare only in the
  37. sense that you may distribute it governed by the following
  38. restrictions: RIPterm may NOT be freely distributed as part of a
  39. commercial or ShareWare software package without written
  40. authorization from TeleGrafix Communications, Inc. ("TeleGrafix").
  41.  
  42. RIPterm may not be modified in any way without prior written consent
  43. from TeleGrafix.  There are two exceptions to the license that do not
  44. violating the license agreement.  They are:
  45.  
  46.     a) You may supply a RIPTERM.PCX file in 640x350 (16 color) format
  47.        which will be displayed while RIPterm is starting up.  The
  48.        purpose is to offer an advertising mechanism for your host.
  49.  
  50.        The lower 1/7th (50 scan lines) of the intro screen is
  51.        reserved for TeleGrafix's copyright information.  Altering of
  52.        the RIPTERM.EXE file to change the copyright violates this
  53.        license agreement.
  54.  
  55.     b) You may also provide a dialing directory file (RIPTERM.PHO) in
  56.        with your host telephone number entered in.
  57.  
  58. RIPterm may not be distributed unless accompanied by all of the 
  59. following files (either in diskette or archive form):
  60.  
  61.     RIPTERM.EXE    <- The RIPterm executable program
  62.     RIPTERM.HLP    <- RIPterm help file
  63.     RIPTERM.DOC    <- RIPterm documentation (this file)
  64.     RIPTERM.FNT    <- RIPterm system font data file
  65.     RIPTERM.RES    <- RIPterm image resource file
  66.     RIPTERM.PCX    <- RIPterm logo file
  67.     WHATSNEW.DOC   <- Details new things in this release
  68.     DIALCONV.EXE   <- Dialing directory conversion utility
  69.  
  70. If you choose the customization features mentioned previously when
  71. distributing RIPterm, you may provide the following files in addition
  72. to the files listed above:
  73.  
  74.     RIPTERM.PCX    <- Logo file to promote your host
  75.     RIPTERM.PHO    <- A "pre-configured" dialing directory file
  76.     <icon files>   <- Icon files for your host
  77.  
  78. ┌────────────────────────────────────────────────────────────────────┐
  79. │                       1.2 ■ LIMITED WARRANTY                       │
  80. └────────────────────────────────────────────────────────────────────┘
  81.  
  82. THIS SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
  83. EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE
  84. IMPLIED WARRANTIES OF MERCHANTABILITY, OR FITNESS FOR A PARTICULAR
  85. PURPOSE.  TELEGRAFIX COMMUNICATIONS, INC. DOES NOT WARRANT THAT THE
  86. FUNCTIONS CONTAINED IN THIS SOFTWARE WILL MEET YOUR REQUIREMENTS OR
  87. THAT THE OPERATION OF THIS SOFTWARE WILL BE UNINTERRUPTED OR ERROR-
  88. FREE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE
  89. SOFTWARE IS WITH THE USER.  SHOULD THE SOFTWARE PROVIDED BE DEFECTIVE,
  90. YOU (NOT TELEGRAFIX COMMUNICATIONS, INC.) ASSUME THE ENTIRE COST OF
  91. ALL NECESSARY SERVICING, REPAIR, OR CORRECTION.
  92.  
  93. SOME STATES DO NOT ALLOW THE EXCLUSION OF IMPLIED WARRANTIES, SO THE
  94. ABOVE EXCLUSION MAY NOT APPLY TO YOU.  THIS WARRANTY GIVES YOU
  95. SPECIFIC LEGAL RIGHTS AND YOU MAY ALSO HAVE OTHER RIGHTS WHICH VARY
  96. FROM STATE TO STATE.
  97.  
  98. IN NO EVENT WILL TELEGRAFIX COMMUNICATIONS, INC. BE LIABLE TO YOU FOR
  99. ANY DAMAGES, INCLUDING ANY LOST PROFITS, LOST SAVINGS OR OTHER
  100. INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR
  101. INABILITY TO USE THE SOFTWARE EVEN IF TELEGRAFIX OR ITS AUTHORIZED
  102. REPRESENTATIVE HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES,
  103. OR FOR ANY CLAIM BY ANY OTHER PARTY.
  104.  
  105. SOME STATES DO NOT ALLOW THE LIMITATION OR EXCLUSION OF LIABILITY FOR
  106. INCIDENTAL OR CONSEQUENTIAL DAMAGES SO THE ABOVE LIMITATION OR
  107. EXCLUSION MAY NOT APPLY TO YOU.
  108.  
  109. YOU MAY NOT SUBLICENSE, ASSIGN OR OTHERWISE TRANSFER THIS LICENSE OR
  110. SOFTWARE EXCEPT AS EXPRESSLY PROVIDED IN THIS AGREEMENT.  ANY ATTEMPT
  111. TO OTHERWISE SUBLICENSE, ASSIGN, OR TRANSFER ANY OF THE RIGHTS,
  112. DUTIES OR OBLIGATIONS HEREUNDER IS EXPRESSLY PROHIBITED AND WILL
  113. TERMINATE THIS AGREEMENT.
  114.  
  115. BY INSTALLING OR USING THIS SOFTWARE, YOU ACKNOWLEDGE THAT YOU HAVE
  116. READ THIS AGREEMENT, UNDERSTAND IT, AND AGREE TO BE BOUND BY ITS
  117. TERMS AND CONDITIONS.  YOU FURTHER AGREE THAT IT IS THE COMPLETE AND
  118. EXCLUSIVE STATEMENT OF THE AGREEMENT BETWEEN US, WHICH SUPERSEDES ANY
  119. PROPOSAL OR PRIOR AGREEMENT, ORAL OR WRITTEN, AND ANY OTHER
  120. COMMUNICATIONS BETWEEN US RELATING TO THE SUBJECT MATTER OF THIS
  121. AGREEMENT.
  122.  
  123. ┌────────────────────────────────────────────────────────────────────┐
  124. │                         1.3 ■ REQUIREMENTS                         │
  125. └────────────────────────────────────────────────────────────────────┘
  126.  
  127. RIPterm requires that you be using an IBM-PC compatible computer
  128. system running MS-DOS version 3.0 or higher.  You must have 512K of
  129. available RAM or more.  A hard disk is strongly recommended.  You
  130. must have an EGA or higher video adapter a modem connected to serial
  131. port COM1 through COM4.  A mouse and a color monitor are not
  132. required, but are strongly recommended.  This software does not
  133. require Extended (XMS) or Expanded (EMS) memory, but can take
  134. advantage of either if present to improve software performance.
  135.  
  136.  
  137. ┌────────────────────────────────────────────────────────────────────┐
  138. │                    1.4 ■ IMPORTANT INFORMATION                     │
  139. └────────────────────────────────────────────────────────────────────┘
  140.  
  141. Complications may arise currently if you have a SERIAL mouse
  142. installed instead of a BUS mouse.  If you get garbage on the screen
  143. when you move the mouse, then there is a conflict with the MODEM port
  144. and the MOUSE port.  Try deleting the RIPTERM.CNF (RIPterm's
  145. configuration) file and restarting RIPterm.  Once inside RIPterm,
  146. press ALT-O (for Options) and verify that your settings are correct
  147. for your PC's configuration.
  148.  
  149. See APPENDIX A - TROUBLESHOOTING (Section A.2) for more details on
  150. this issue.
  151.  
  152.  
  153. ┌────────────────────────────────────────────────────────────────────┐
  154. │                         1.5 ■ INSTALLATION                         │
  155. └────────────────────────────────────────────────────────────────────┘
  156.  
  157. Create a directory on your hard disk called RIPTERM.  Under that
  158. directory, create another directory called ICONS.  For example:
  159.  
  160.     md \RIPTERM
  161.     md \RIPTERM\ICONS
  162.  
  163. Copy all .ICN, .MSK, and .HIC files into the ICONS directory, and all
  164. remaining files into the RIPTERM directory.  Type RIPTERM to start up
  165. the software.  It will ask you which port your modem is connected to
  166. and the baud rate to use.
  167.  
  168. If you forget to perform any of these steps, or you UNZIP RIPterm
  169. from the distribution archive without extracting sub-directory info,
  170. RIPterm will accommodate the oversight by prompting you to copy
  171. the necessary icon files over to the correct ICONS\ directory.
  172.  
  173.  
  174. ┌────────────────────────────────────────────────────────────────────┐
  175. │                      1.6 ■ GLOSSARY OF TERMS                       │
  176. └────────────────────────────────────────────────────────────────────┘
  177.  
  178. host - refers to the system you are connected to.  This can be a BBS,
  179.        a mainframe, a network application, whatever.
  180.  
  181. icon - an icon is a bit map graphic of varying size.  Icon files may
  182.        end in .ICN, .MSK (mask files), or .HIC (hot icons - used with
  183.        buttons)
  184.  
  185. ┌────────────────────────────────────────────────────────────────────┐
  186. │                          1.7 ■ TRADEMARKS                          │
  187. └────────────────────────────────────────────────────────────────────┘
  188.  
  189. RIPterm, RIPscrip, RIPaint, the RIPterm logo, TeleGrafix
  190. Communications, and the TeleGrafix Communications logo are all
  191. trademarks of TeleGrafix Communications, Inc.
  192.  
  193. All other trademarks are trademarks of their respective holders.
  194.  
  195. ┌────────────────────────────────────────────────────────────────────┐
  196. │                     2.0 ■ PROGRAM INFORMATION                      │
  197. └────────────────────────────────────────────────────────────────────┘
  198.  
  199. RIPterm has a number of features which make it a useful terminal
  200. program.  Among the many features are the following:
  201.  
  202.     ■ RIPscrip graphics viewing ability
  203.  
  204.     ■ Graphics mode operation - 16-color, 640x350 resolution
  205.  
  206.     ■ Scrollback mode to review text transmitted from host
  207.  
  208.     ■ Editable Keystroke Macros with load/save ability
  209.  
  210.     ■ Log-to-Disk ability
  211.  
  212.     ■ Full ANSI support (plus some VT-102 and VT-52 support)
  213.  
  214.     ■ Supports COM1 through COM4
  215.  
  216.     ■ Custom IRQ and base I/O address settings
  217.  
  218.     ■ Context sensitive, keyword driven help system
  219.  
  220.     ■ Pull-down menu operation as well as complete hot-key support
  221.  
  222.     ■ Fully configurable modem settings
  223.  
  224.     ■ Auto-redial feature
  225.  
  226.     ■ Auto-answer mode
  227.  
  228.     ■ Batch upload/download ability
  229.  
  230.     ■ Auto Z-Modem downloads
  231.  
  232.     ■ Upload ASCII files with optional line/character pacing
  233.  
  234.     ■ Shell to DOS capability
  235.  
  236.     ■ EMS/XMS/overlay support to maximize memory efficiency
  237.  
  238.     ■ Automatically moves icons to the ICONS\ directory if
  239.       there are any in the RIPTERM directory (wrong place).
  240.  
  241.  
  242.     ┌──────────────────────────┐
  243.     │ NEW FEATURES IN v1.50.00 │
  244.     └──────────────────────────┘
  245.  
  246.  
  247.     ■ RIPterm no longer needs a mouse!  You may access ANY mouse
  248.       field in a RIPscrip menu without the mouse by using the TAB or
  249.       SHIFT-TAB keys to highlight the field you want to execute.
  250.       Once the desired field is highlighted, simply press the <ENTER>
  251.       key to activate the mouse field.
  252.  
  253.     ■ You can now access the menus via the keyboard by pressing the
  254.       F10 key.  You may navigate through the menus with the arrow
  255.       keys and pressing <ENTER> on the desired item to activate it.
  256.  
  257.     ■ Set the default System Font ability, to alter the size of
  258.       ASCII/ANSI text on your screen.
  259.  
  260.     ■ Built-in text variable system for keystroke macros, and for
  261.       host/terminal information exchange.
  262.  
  263.     ■ Pop-up lists in keystroke macros.
  264.  
  265.     ■ Doorway mode (uses Marshall Dudley's DOORWAY access program)
  266.  
  267.     ■ Support for 101-key keyboard in doorway mode
  268.  
  269.     ■ Enhanced keyboard override when starting up RIPterm (for
  270.       troubleshooting 101-key keyboard settings).
  271.  
  272.     ■ RIPterm now auto-senses if a connection exists, and if it does,
  273.       it does not send the modem init string.  If the connection is a
  274.       modem, RIPterm simply press <ENTER> to the host to (ideally)
  275.       re-display the current menu.  If the connection is a serial
  276.       link, nothing is sent.
  277.  
  278.     ■ RIPterm will now auto-sense RIPscrip with the ANSI sequence
  279.       <ESC>[! ... it will return "RIPSCRIP015000" (the RIPscrip
  280.       version number, i.e., "v01.50.00").
  281.  
  282.     ■ A new start up option (/O) to indicate you're already on-line.
  283.  
  284.     ■ Completely rewritten text-scrolling!  Now 10 times faster!
  285.  
  286.     ■ Re-engineered file transfer protocols.  RIPterm supports the
  287.       following protocols:
  288.  
  289.           X-Modem (checksum)
  290.           X-Modem (CRC)
  291.           X-Modem-1K
  292.           X-Modem-G-1K
  293.           Y-Modem Batch
  294.           Y-Modem-G
  295.           Z-Modem
  296.           Kermit
  297.           ASCII
  298.  
  299.           NOTE: Z-Modem now has crash recovery
  300.  
  301.     ■ Better support for flow control handshaking.  RTS/CTS support
  302.       has been added for better high-speed performance.
  303.  
  304.     ■ Baud rates up to 115,200 are now supported.  4800 baud is also
  305.       a choice now.
  306.  
  307.     ■ The Modem Options dialog box has been restructured to be less
  308.       confusing, and more pleasing to the eye.
  309.  
  310.     ■ Help system has been overhauled (access by pressing F1).
  311.  
  312.     ■ Scrolling up/down one line in the scrollback buffer no longer
  313.       trims spaces from the beginning of printed lines.  This gives
  314.       an accurate representation of what the text looked like.
  315.  
  316.     ■ CR and LF characters are now properly handled.
  317.  
  318.     ■ Word-wrap no longer occurs on column #80, but at column 81.
  319.       This became evident with large ANSI pictures becoming messed
  320.       up due to premature word wrapping.
  321.  
  322.     ■ Text Variables and dynamic information query from the host (see
  323.       keystroke macro section for more details).
  324.  
  325.     ■ Local Database (RIPTERM.DB & RIPTERM.IDX) for storage of
  326.       frequently used information.  This can be used in conjunction
  327.       with keystroke macros.  See keystroke macros for further
  328.       information.
  329.  
  330.     ■ Full featured dialing directory.
  331.  
  332.     ■ Icons may be kept in separate sub-directories for different
  333.       hosts.  Specify which host's icons go where in the dialing
  334.       directory ID field.
  335.  
  336.     ■ New command line options for specifying alternate set-up files,
  337.       alternate dialing directory files, and to automatically dial
  338.       an entry in the dialing directory upon start up.  Type
  339.       "RIPTERM ?" for more details.
  340.  
  341.     ■ Re-engineered internal memory management.  RIPterm now uses
  342.       memory more efficiently than previous versions.
  343.  
  344.     ■ The option to insert information into the RIPterm database
  345.       on your own.
  346.  
  347.     ■ Auto download feature for hosts that can take advantage of it.
  348.       This allows protocols like X-Modem to auto-download like
  349.       Z-Modem does (see Block Protocol option).
  350.  
  351.     ■ New Block Protocol option - This is for use on RIPscrip hosts
  352.       where an error-free transmission of icons or RIP scenes is
  353.       desired.  RIPterm accomplishes this transfer of information
  354.       with its built-in file transfer protocols.
  355.  
  356.     ■ Progress indicator on any upload/download that supports
  357.       batch transfer (i.e., Y-Modem, Y-Modem-G, Kermit and Z-Modem).
  358.  
  359.     ■ Option to use DTR to hang-up the modem instead of the less
  360.       efficient +++ ATH method.
  361.  
  362.     ■ Support for many new ANSI escape code sequences (some VT-102
  363.       and VT-52 features now supported).  The new ANSI codes
  364.       processed are:
  365.  
  366.           ■ Underline mode now supported in "display attributes"
  367.           ■ Blink mode now displays as BOLD (bright)
  368.           ■ Invert video mode now acts properly
  369.           ■ Tab stops are fully supported now
  370.           ■ Scrolling regions now supported
  371.           ■ Device status reports
  372.           ■ Extended save/restore cursor (ESC 7, ESC 8) added
  373.           ■ Reset terminal emulation command (ESC c)
  374.           ■ Device attribute report (ESC Z)
  375.           ■ Cursor UP/DOWN with scrolling (ESC D, ESC M, ESC E)
  376.  
  377.     ■ DOS Shell mode spruced up a bit - now displays a modified
  378.       DOS Prompt to indicate you are inside a DOS Shell.
  379.  
  380.     ■ New intro screen mode.  You may now view a .PCX file upon start
  381.       up in place of the standard logo screen.  If the file
  382.       RIPTERM.PCX is present in your RIPterm directory, it will be
  383.       shown.  The TeleGrafix copyright message will be displayed from
  384.       scan lines 300-349.  .PCX logo files must be 16-color EGA
  385.       640x350 images using the STAND COLOR PALETTE.
  386.  
  387.     ■ A new RIPTERM.RES (resource) file is included with RIPterm.
  388.       This file contains many of the frequently used graphical images
  389.       that are used internally in RIPterm.  Host icons are NOT stored
  390.       in this file.
  391.  
  392.     ■ Local RIPscrip file playback ability.  The host can now
  393.       transfer a .RIP file to your system, and then later on instruct
  394.       your system to play it back locally.  Graphics playback is
  395.       lightning fast in this mode.
  396.  
  397.     ■ New option to disable beeps has been added for situations where
  398.       you want peace and quiet.
  399.  
  400.     ■ Status bar has been re-designed.  It is now shorter, thus
  401.       allowing a full 80x24 screen when in certain system font
  402.       modes.  In addition, you can now "click" on fields in the
  403.       status bar and the appropriate command will be executed.
  404.  
  405.     ■ Data security mode has been added to prevent unauthorized
  406.       queries from your local database by a host.  This mode
  407.       was added so that as the user have control on what types of
  408.       information a host can ask your terminal.
  409.  
  410.  
  411. ┌────────────────────────────────────────────────────────────────────┐
  412. │                           2.1 ■ FEATURES                           │
  413. └────────────────────────────────────────────────────────────────────┘
  414.  
  415. This section gives more detailed information on RIPterm's features
  416. and options.  To select the HELP option, press F1.
  417.  
  418.  
  419. ┌────────────────────────────────────────────────────────────────────┐
  420. │                    2.1.1 ■ GETTING ON-LINE HELP                    │
  421. └────────────────────────────────────────────────────────────────────┘
  422.  
  423. The help system of RIPterm is easy to use.  To return to the Table of
  424. Contents at any time, click on the "Contents" button at the bottom of
  425. the screen.  If you have navigated through various help screens, you
  426. can back-up to the previous screen by clicking on the "Back" button.
  427. Any words or phrases which are highlighted (light blue on color
  428. monitors) are "keywords" which you can click on to jump to that help
  429. topic.  You may use the UP/DOWN/LEFT/RIGHT keys to navigate through
  430. the help screen's keywords, or you may use the TAB or SHIFT-TAB to
  431. highlight different keywords.  The arrow keys may also be used.  Tap
  432. <ENTER> and the currently selected keyword will be selected, and you
  433. will be taken to that help screen.
  434.  
  435. The Help System Table of Contents may also be accessed by clicking on
  436. "Press F1 for Help" in the Status Bar.
  437.  
  438.  
  439. ┌────────────────────────────────────────────────────────────────────┐
  440. │                      2.1.2 ■ PULL-DOWN MENUS                       │
  441. └────────────────────────────────────────────────────────────────────┘
  442.  
  443. To activate the pull down menus, move the mouse pointer to the top of
  444. the screen and press and hold down the right mouse button.  A menu
  445. bar will appear at the top of the screen.  Move the mouse pointer to
  446. any of these items and a list of menu options will appear below the
  447. menu bar.  At this point, move the mouse down into this list of items
  448. and as you move over different items, they will be highlighted.  To
  449. select any given item, release the right mouse button while the
  450. desired option is highlighted.
  451.  
  452. All options in the pull down menus have corresponding hot-keys that
  453. you can use.  Hot-keys are keyboard short cuts for menu options.
  454. Hot-keys make it so that you do not have to use the mouse to access
  455. the menu.
  456.  
  457. Some menu options are "toggle" items.  If an option is toggled ON,
  458. then you will see a check-mark beside the option indicating that it
  459. is active.  Select these options to toggle the state ON or OFF.
  460.  
  461. You may access the menu system without the mouse by pressing the F10
  462. key.  When selected, the menu bar will appear with one of the menu
  463. items highlighted.  Use the RIGHT and LEFT keys to highlight the
  464. desired menu item, then press the PGDN, DOWN or ENTER keys to display
  465. a list of menu contents for the specified topic.  Use the UP/DOWN
  466. keys to highlight a particular item in the list.  The HOME and END
  467. keys work as you would expect them to.  While a menu is displayed
  468. completely, you may use the LEFT and RIGHT arrow keys to move to an
  469. adjacent menu topic. Pressing PGUP or ESC while a menu is displayed
  470. will remove the list of menu options, and return you to the menu bar
  471. only.  Pressing ESC again will terminate the menu bar mode and return
  472. you to your RIPterm session. If you select options while accessing
  473. the menu with the keyboard, when the option is finished executing,
  474. you will be returned to the pull-down menu so that you can execute
  475. other options quickly.
  476.  
  477. The remaining portion of this section describes each menu, and how
  478. each options functions.
  479.  
  480.  
  481. ┌────────────────────────────────────────────────────────────────────┐
  482. │                    2.1.2.1 ■ THE "PROJECT" MENU                    │
  483. └────────────────────────────────────────────────────────────────────┘
  484.  
  485.     This menu contains many general RIPterm functions:
  486.  
  487.     ┌───────────────┐
  488.     │ ABOUT RIPTERM │
  489.     └───────────────┘
  490.  
  491.     This option will display a help screen displaying the copyright
  492.     information for RIPterm.
  493.  
  494.     ┌─────────────┐
  495.     │ SYSTEM INFO │
  496.     └─────────────┘
  497.  
  498.     This option will display the amount of RAM memory currently
  499.     available as well as the amount of disk space free on the
  500.     currently selected hard disk.
  501.  
  502.     ┌─────────────┐
  503.     │ HELP SYSTEM │
  504.     └─────────────┘
  505.  
  506.     This option will display the help system's Table of Contents.
  507.  
  508.     ┌───────────────┐
  509.     │ HELP ON MENUS │
  510.     └───────────────┘
  511.  
  512.     This option will allow you to view help information on the
  513.     menus.  A window will appear instructing you to select a menu
  514.     option.  Depress the right mouse button and pull down the desired
  515.     menu.  Select an option, and a help screen will appear for that
  516.     item.  When finished, press <ESC> to exit "Menu Help" mode.
  517.  
  518.     ┌───────────────┐
  519.     │ OPEN LOG FILE │
  520.     └───────────────┘
  521.  
  522.     A log file captures text transmitted from the host into a text
  523.     file.  ANSI color codes and RIPscrip graphics commands are
  524.     filtered out for your convenience.  This command can be very
  525.     powerful on hosts where you want to save data coming across the
  526.     screen to a file that you can read when off-line, at your leisure.
  527.     A log file can be as big as you want, up to the amount of
  528.     currently available disk space.
  529.  
  530.     To open a log file, select "Open Log File" from the menu.  You
  531.     will be prompted for a filename.  When a log file is open, the
  532.     menu option "Open Log File" changes to "Pause/Close Log", and the
  533.     status bar will show the log file name in the third spot from the
  534.     left, where the terminal emulation is normally displayed.
  535.  
  536.     If a log file is currently open, selecting "Pause/Close Log" from
  537.     the menu, or clicking on the filename in the status bar will give
  538.     you the option to either pause the log, or to close the file.
  539.     Pausing "suspends" logging to disk temporarily so that you can do
  540.     things without saving them to the log file.  If you are currently
  541.     paused, selecting "Pause/Close Log" again or clicking on the
  542.     filename in the status bar will prompt you to either resume, or
  543.     close the log.
  544.  
  545.     If a log file is open, and you choose EXIT RIPTERM, it will be
  546.     automatically closed.
  547.  
  548.     ┌─────────────┐
  549.     │ JUMP TO DOS │
  550.     └─────────────┘
  551.  
  552.     The "Jump to DOS" feature allows you to shell out to an MS-DOS
  553.     command line while remaining in RIPterm.  You would use this if
  554.     you wanted to obtain a DOS directory, or to run an editor, or use
  555.     DOS in general.  To return to RIPterm from the DOS command line,
  556.     type "EXIT".
  557.  
  558.     RIPterm will display a special DOS prompt indicating that are
  559.     currently running RIPterm, but executing a DOS shell.  You may
  560.     use any disk drive you want, or change directories.  When you
  561.     type "EXIT", RIPterm will return to your default RIPterm
  562.     directory so that it can re-load files for you.  When you return
  563.     to your RIPterm session, the current graphics screen is restored
  564.     as well as any mouse fields, or other parameters.
  565.  
  566.     ┌──────┐
  567.     │ EXIT │
  568.     └──────┘
  569.  
  570.     This exits RIPterm and return you to DOS.  If your modem
  571.     configuration is set to "modem dialing", and you are currently
  572.     on-line, a dialog box will appear asking if you wish to hang-up
  573.     before exiting.  If you choose NO at this option, you will remain
  574.     on-line even after you have exited to DOS.  Use this option with
  575.     caution, as if you forget that you are on-line, you could charge
  576.     up a considerable long distance bill.
  577.  
  578. ┌────────────────────────────────────────────────────────────────────┐
  579. │                    2.1.2.2 ■ THE "OPTIONS" MENU                    │
  580. └────────────────────────────────────────────────────────────────────┘
  581.  
  582.     This menu contains many options that can be used to alter
  583.     RIPterm's basic configuration, and mode of operation:
  584.  
  585.     ┌─────────────┐
  586.     │ STATUS LINE │
  587.     └─────────────┘
  588.  
  589.     The status line displays various important information about the
  590.     current State of RIPterm.  Information displayed left to right:
  591.  
  592.         ┌───────────┬─────────────┬──────────┬─────────────────┬
  593.         │ F1 = Help │ F10 = Menus │ RIPscrip │ 38400 ■ N81 FDX │
  594.         └───────────┴─────────────┴──────────┴─────────────────┴
  595.              (1)          (2)          (3)      (4)      (5)
  596.  
  597.         ┬──────┬──────────────────┬─────────┐
  598.         │ COM1 │ RIPterm v1.50.00 │ Offline │
  599.         ┴──────┴──────────────────┴─────────┘
  600.           (6)           (7)           (8)
  601.  
  602.         (1) How to get the help system table of contents
  603.  
  604.         (2) How to use the keyboard only to select from the menus
  605.  
  606.         (3) What terminal emulation is in use, or the name of the log
  607.             file if one has been opened
  608.  
  609.         (4) The baud rate, parity setting, data bits and stop bits
  610.  
  611.         (5) Full-duplex (FDX) or half-duplex (HDX)settings
  612.  
  613.         (6) The COM port that is currently in use
  614.  
  615.         (7) The current version number of RIPterm
  616.  
  617.         (8) Whether you are "on-line" or "off-line"
  618.  
  619.     To display or hide the status line, press ALT-SPACE.
  620.  
  621.     ┌──────────────┐
  622.     │ ZOOM WINDOWS │
  623.     └──────────────┘
  624.  
  625.     In RIPterm, whenever a window or dialog box pops up on the
  626.     screen, it will "zoom in" and "zoom out" giving a visual feeling
  627.     of the window opening or closing.  This will slow down operation
  628.     of the windowing system a small amount.  For optimal performance
  629.     of RIPterm, toggle zoom windows off.  However, the visual
  630.     impression of windows opening or closing can be quite useful.
  631.  
  632.     ┌──────────────────┐
  633.     │ 101-KEY KEYBOARD │
  634.     └──────────────────┘
  635.  
  636.     This mode is used in the "doorway mode" (see below).  It allows
  637.     you to send extended 101-key keyboard codes to the doorway system
  638.     running on the host.  This mode is only available on AT
  639.     computers with a 101-key enhanced AT keyboard.  If this option
  640.     locks up your system, disable it.
  641.  
  642.     This value is part of the RIPterm setup, saved in RIPTERM.CNF.
  643.     If you set this option ON, and it locks your system, and your
  644.     system locks whenever you start up RIPterm, then the option has
  645.     been saved to your setup.  You should run RIPterm with the -E
  646.     option, like this:
  647.  
  648.         RIPTERM -E
  649.  
  650.     The first thing you should do is disable the 101-key keyboard
  651.     option and save your setup with ALT-S.  The -E option overrides
  652.     Enhanced 101-key keyboard support for the duration of the current
  653.     session of RIPterm.
  654.  
  655.     ┌───────────────────────┐
  656.     │ CLEAR GRAPHICS WINDOW │
  657.     └───────────────────────┘
  658.  
  659.     RIPterm uses two windows in RIPscrip graphics mode, a graphics
  660.     window and a text window.  The text window is where all
  661.     non-graphics data is displayed.  The graphics window is where all
  662.     graphical RIPscrip commands are displayed.
  663.  
  664.     Choose this option to clear the graphics window only.  If the
  665.     graphics window overlaps the text window, then some of the text
  666.     may be erased in the process.  The window is cleared to the
  667.     current background color, which by default is BLACK.
  668.  
  669.     NOTE: The graphics window is ALWAYS set to the full screen.
  670.  
  671.     ┌───────────────────────┐
  672.     │ CLEAR THE TEXT WINDOW │
  673.     └───────────────────────┘
  674.  
  675.     RIPterm uses two windows in RIPscrip graphics mode, a graphics
  676.     window and a text window.  The graphics window is where all
  677.     graphical RIPscrip commands are displayed.  The text window is
  678.     where all non-graphics data is displayed.
  679.  
  680.     Choose this option to clear the text window only.  If the text
  681.     window overlaps the graphics window, then some of the graphics
  682.     may be erased in the process.  The window is cleared to BLACK and
  683.     the cursor moved to the upper left corner of the window.
  684.  
  685.     NOTE: The text window, by default, is full screen.  This may be
  686.           changed by RIPscrip graphics commands.
  687.  
  688.     ┌───────────────────┐
  689.     │ RESET ALL WINDOWS │
  690.     └───────────────────┘
  691.  
  692.     This command will reset the text and graphics windows to full
  693.     screen.  In addition, the screen is cleared and the cursor moved
  694.     to the upper left hand corner of the screen.  This is equivalent
  695.     to a clear screen command in other software packages.  The color
  696.     palette is reset to the standard 16 ANSI colors, and the font is
  697.     reset to the system default you have selected.
  698.  
  699.     ┌────────────────────────┐
  700.     │ VIEW SCROLLBACK BUFFER │
  701.     └────────────────────────┘
  702.  
  703.     This option will activate the text scrollback system.  This
  704.     allows you to view previously displayed text information that has
  705.     come across the modem.  You may set the scrollback buffer size
  706.     to 5k - 64k of memory.
  707.  
  708.     Within scrollback, you may choose from the following options:
  709.  
  710.          SAVE buffer page to a text file
  711.          SAVE entire buffer to a text file
  712.          PRINT the current buffer page, or the entire buffer
  713.          SEARCH for a particular piece of text
  714.          Search AGAIN for a previously searched for text string
  715.  
  716.     At the top of the scrollback screen are buttons for the above
  717.     commands.  In addition, there are buttons for scrolling up and
  718.     down, paging up and down, or moving to the beginning or end of
  719.     the buffer.
  720.  
  721.     NOTE: The scrollback buffer filters out ANSI color codes and
  722.           RIPscrip graphics for an uncluttered text display.
  723.  
  724.     ┌─────────────────────┐
  725.     │ SET SCROLLBACK SIZE │
  726.     └─────────────────────┘
  727.  
  728.     This option sets how much memory RIPterm should use for the
  729.     scrollback buffer.  The valid settings are from 5k - 64k of
  730.     memory.  Depending on how much conventional memory you have on
  731.     your computer, this may limit the amount of memory you can
  732.     allocate to scrollback.  We recommend that you set it to
  733.     somewhere around 32k unless you know that your PC has quite a bit
  734.     of its 640k memory free for use.  If you have numerous memory
  735.     resident programs (TSR's) loaded, you may need to drop the size
  736.     of your scrollback buffer to a smaller value for proper
  737.     operation of RIPterm.
  738.  
  739.     If RIPterm runs out of memory, it will begin to discard old
  740.     scrollback buffer information until it can satisfy the memory
  741.     request.
  742.  
  743.     ┌────────────────────────┐
  744.     │ KEYSTROKE MACRO EDITOR │
  745.     └────────────────────────┘
  746.  
  747.     Macros are functions that you can define to perform short-cut
  748.     operations on the host.  For example, you can instruct
  749.     RIPterm to make the F5 key type your User-ID and press <ENTER>
  750.     for you.  This would allow you to log-on quickly by simply
  751.     pressing a single key. RIPterm's macro system is easy to use, and
  752.     very powerful!  You can save your macro keys to the default macro
  753.     file (RIPTERM.KEY), or if you need to have multiple macro
  754.     configurations, you can save macros to different files.
  755.  
  756.     ┌─────────────┐
  757.     │ SYSTEM FONT │
  758.     └─────────────┘
  759.  
  760.     The System Font allows you to select the font that is used in
  761.     text/ANSI mode.  It does not have any effect on the graphics
  762.     shown. Any subsequent text/ANSI displayed on the screen will
  763.     appear in the chosen system font unless the host explicitly tells
  764.     it to use another font for the text window.
  765.  
  766.     This mode allows you to specify how "large" text is when you are
  767.     in full-screen text mode.  You have five separate System Fonts to
  768.     choose from.  They are:
  769.  
  770.             80x43 - default
  771.             80x25 - normal DOS screen size
  772.             40x25 - low-resolution font
  773.             91x43 - get more columns of text at once
  774.             91x25 - get more columns of text at once
  775.  
  776.     ┌──────────────┐
  777.     │ DOORWAY MODE │
  778.     └──────────────┘
  779.  
  780.     This mode is of use on a number of host packages that take
  781.     advantage of "Doors".  When in Doorway mode, any keystroke that
  782.     you enter on your keyboard is transmitted to the host regardless
  783.     of the fact that the keystroke might be a menu shortcut, or
  784.     something that RIPterm would normally process locally.  This
  785.     allows you to use special keystrokes (like INSERT, DELETE, PGUP,
  786.     Function Keys, etc.) on a host program that can take advantage of
  787.     it. The most popular program that takes advantage of this mode is
  788.     DOORWAY by Marshall Dudley.
  789.  
  790.         PROGRAMMER'S NOTE:
  791.  
  792.             For the technical minded who want to know how this works,
  793.             this is what's going on:
  794.  
  795.               ■ The keystroke is recorded using BIOS interrupt
  796.                 0x16, sub-function 0x00 for non-101-key keyboards,
  797.                 or sub-function 0x10 for 101-key keyboards.
  798.  
  799.               ■ If register AL contains a value (the ASCII
  800.                 character), and AH is equal to 0, then it is
  801.                 sent to the host by transmitting the character
  802.                 directly over the comm port.
  803.  
  804.               ■ If AH is not 0, then transmit the contents of AH
  805.                 instead to the host by transmitting a null (0),
  806.                 then the contents of AH.  If AL == E0, and AH != 0,
  807.                 then it is an enhanced 101-key scancode and should
  808.                 be sent to the host as a null (0), followed by an
  809.                 0xE0, then followed by the raw scan code.
  810.  
  811.     ┌───────────────┐
  812.     │ DISABLE BEEPS │
  813.     └───────────────┘
  814.  
  815.     This will disable the Beep character (ASCII character 7, BEL)
  816.     from being played on the PC speaker when received from the host.
  817.     This makes RIPterm "quiet" when you want it to be.  This does not
  818.     override all sounds; just BEEP characters received from the host.
  819.  
  820.     ┌────────────────────┐
  821.     │ DROP DTR TO HANGUP │
  822.     └────────────────────┘
  823.  
  824.     This option will lower DTR for approximately two seconds to
  825.     disconnect the modem.  If for some reason, the modem still hasn't
  826.     disconnected, hang-up will default to the typical method of
  827.     issuing a +++, followed by an ATH to hang-up the modem.  If after
  828.     all hang-up processing is complete, and the Modem still hasn't
  829.     disconnected, a message saying "Hang-up Failed" will be displayed.
  830.  
  831.     ┌────────────────────┐
  832.     │ MOUSE FIELD SELECT │
  833.     └────────────────────┘
  834.  
  835.     This option, when check marked, will use TAB and SHIFT-TAB to
  836.     select, in order, the mouse fields defined on the screen.
  837.  
  838.     If this item is not check marked, the TAB character (control-I) is
  839.     transmitted to the host.
  840.  
  841. ┌────────────────────────────────────────────────────────────────────┐
  842. │                     2.1.2.3 ■ THE "MODEM" MENU                     │
  843. └────────────────────────────────────────────────────────────────────┘
  844.  
  845. The modem menu contains options that alter the way the modem works
  846. with RIPterm.  Depending on what type of host you are trying to dial,
  847. or what configuration your modem is set to, you may have to alter the
  848. modem's configuration to best suit your own needs.
  849.  
  850.     ┌────────────────┐
  851.     │ MODEM SETTINGS │
  852.     └────────────────┘
  853.  
  854.     This dialog box will allow you to modify your modem configuration.
  855.     You may alter the modem initialization commands, the auto-answer
  856.     string or the modem reset command string.  These options use
  857.     standard Hayes-compatible modem commands.  If you wish to insert a
  858.     "pause" into the command, simply insert a comma (,).
  859.  
  860.     In addition to modem commands, you may set the current COM port,
  861.     the data bits, stop bits, parity setting and baud rate.  Standard
  862.     settings are either 8 data bits, 1 stop bit and NO parity (8N1),
  863.     or 7 data bits, 1 stop bit and EVEN parity (7E1).  Additional
  864.     options allow you to specify touch tone or rotary (pulse)
  865.     dialing, the number of seconds to wait for a connection (redial
  866.     time), whether to add CR/LF combinations and whether RIPterm is
  867.     connected directly to a modem or not.  You may also specify flow
  868.     control for the serial port as either XON/XOFF (software flow
  869.     control), or RTS/CTS control (hardware control - more reliable).
  870.     If you specify RTS/CTS flow control, make sure your modem cable
  871.     can support the specific signals that would make this mode work
  872.     properly.  Most commonly available serial cables support this
  873.     feature now.  If you have an internal modem, then this mode
  874.     should work for you automatically.
  875.  
  876.     One final option on this dialog box is the "Use Modem" option. If
  877.     selected (the default), then RIPterm assumes it is connected to a
  878.     modem.  If it is disabled, then RIPterm thinks it is connected to
  879.     another computer directly using a modem eliminator cable (also
  880.     known as a "NULL MODEM" cable).
  881.  
  882.     To alter the serial port IRQ settings, choose the INTERRUPT SETUP
  883.     option.  To alter serial port addresses, choose the option SERIAL
  884.     ADDRESSES from the OPTIONS menu.
  885.  
  886.     These settings are part of the setup, so once you alter them, you
  887.     should choose the SAVE SETUP option to make them permanent.
  888.  
  889.     ┌────────────┐
  890.     │ SAVE SETUP │
  891.     └────────────┘
  892.  
  893.     This option will save a number of configuration parameters for
  894.     RIPterm.  Among the various items maintained in the Setup are:
  895.  
  896.         ■ Modem Setup
  897.  
  898.         ■ Zooming Windows ON/OFF
  899.  
  900.         ■ Status Bar ON/OFF
  901.  
  902.         ■ Serial Port Interrupt settings   (for all four ports)
  903.  
  904.         ■ Serial Port I/O Address settings (for all four ports)
  905.  
  906.         ■ CR/LF settings
  907.  
  908.         ■ Echo Keystrokes setting (duplex)
  909.  
  910.         ■ Scrollback Buffer Size
  911.  
  912.         ■ Dialing Directory TOGGLE status
  913.  
  914.         ■ Use DTR to Hang-up status
  915.  
  916.         ■ Data Security status
  917.  
  918.         ■ 101-key Enhanced Keyboard status
  919.  
  920.         ■ ASCII upload settings
  921.  
  922.         ■ Default System Font
  923.  
  924.         ■ Beep ON/OFF status
  925.  
  926.     Each time you load RIPterm, the setup is loaded and used for the
  927.     current session.
  928.  
  929.     Setup information is contained in a file called RIPTERM.CNF by
  930.     default.  This can be altered by using the -S parameter when
  931.     starting up RIPterm.  This option instructs RIPterm to use an
  932.     alternate setup file (e.g., RIPTERM -Smysetup.cnf).
  933.  
  934.     ┌─────────────────┐
  935.     │ ECHO KEYSTROKES │
  936.     └─────────────────┘
  937.  
  938.     This command will toggle whether RIPterm should echo keystrokes
  939.     to the terminal locally, or let the host perform the echoing.
  940.     Normally, the host will do this for you, so echo is OFF by
  941.     default.  In some situations though, you may wish to toggle ECHO
  942.     ON.  One such situation is if you are directly connected to
  943.     another person's computer via modem and are typing to them in a
  944.     "chat-like" manner.
  945.  
  946.     ┌───────────────────┐
  947.     │ DIALING DIRECTORY │
  948.     └───────────────────┘
  949.  
  950.     This option displays the current dialing directory on your
  951.     screen.  From this dialog box, you may dial, edit or otherwise
  952.     manipulate any of the dialing directory entries in any way you
  953.     wish. There is a complete section of this document devoted
  954.     specifically to the dialing directory.  Read on for details.
  955.  
  956.     You may also access this mode by clicking on the "off-line" field
  957.     of the status bar.  This field will automatically change to
  958.     "on-line" when connected to a host.  Clicking on this field when
  959.     on-line will activate the hang-up option.
  960.  
  961.     ┌───────────────────┐
  962.     │ HANG-UP THE MODEM │
  963.     └───────────────────┘
  964.  
  965.     This option will attempt to disconnect the modem, thus logging
  966.     you off of whatever host you are connected to.
  967.  
  968.     You may also hang-up the modem by clicking on the "On-line" field
  969.     of the Status Bar.
  970.  
  971.     If for some reason, RIPterm was unable to successfully disconnect
  972.     the modem, the message "Hang-up Failed" will be displayed.
  973.  
  974.     ┌───────────┐
  975.     │ ADD CR/LF │
  976.     └───────────┘
  977.  
  978.     This option will add CR/LF combinations at the end of text lines.
  979.     Normally, this is not necessary.  Some hosts however, require
  980.     that CR/LF's be ON for you to see text properly.  Normally, this
  981.     option is OFF.  You may toggle it ON if need be.
  982.  
  983.     If text coming across the modem does not move to the next line,
  984.     then you need to turn this option ON.  If every line of text is
  985.     separated by a blank line, then you need to toggle this OFF.
  986.  
  987.     ┌─────────────────────────────┐
  988.     │ SERIAL PORT INTERRUPT SETUP │
  989.     └─────────────────────────────┘
  990.  
  991.     THIS IS AN ADVANCED OPTION AND SHOULD NOT BE USED UNLESS YOU ARE
  992.     FAMILIAR WITH IBM-PC INTERRUPTS AND HARDWARE SETUP!
  993.  
  994.     This option allows you to customize the Interrupt (IRQ) settings
  995.     for each of your four COM ports.  Normally this isn't necessary.
  996.     However, some PC's have special configurations that require the
  997.     terminal's setup to be altered if the serial ports are to
  998.     function properly.
  999.  
  1000.     There are five different interrupts that can be selected for each
  1001.     COM port (2, 3, 4, 5, and 7).  If two serial ports in the
  1002.     computer use the same interrupt (i.e., a conflict), then problems
  1003.     may arise.
  1004.  
  1005.     ┌───────────────────────────┐
  1006.     │ SERIAL PORT ADDRESS SETUP │
  1007.     └───────────────────────────┘
  1008.  
  1009.     THIS IS AN ADVANCED OPTION AND SHOULD NOT BE USED UNLESS YOU ARE
  1010.     FAMILIAR WITH IBM-PC BASE I/O ADDRESSES AND HARDWARE SETUP!
  1011.  
  1012.     This option allows you to customize the base I/O addresses of the
  1013.     four COM ports that RIPterm can utilize.  Normally, you will not
  1014.     need to alter these settings.  If you are a PC technician, or you
  1015.     have serial port configuration that doesn't comply with the
  1016.     COM1-COM4 standards, you may need to alter your addresses for
  1017.     these ports to make RIPterm function properly.  The standard
  1018.     addresses for COM1-4 are as follows on an AT compatible computer:
  1019.  
  1020.         PORT    ADDRESS    IRQ
  1021.         ----------------------
  1022.         COM1      3F8       4
  1023.         COM2      2F8       3
  1024.         COM3      3E8       4
  1025.         COM4      2E8       3
  1026.  
  1027.     ┌──────────────────┐
  1028.     │ INITIALIZE MODEM │
  1029.     └──────────────────┘
  1030.  
  1031.     Choosing this option will reset the modem, and send the modem
  1032.     initialization string to the modem.  This will effectively reset
  1033.     the modem to the configured default settings.
  1034.  
  1035.     The commands sent to the modem can be altered by choosing modem
  1036.     settings from the Modem menu, or by pressing ALT-O.
  1037.  
  1038.     ┌───────────────────┐
  1039.     │ MODEM AUTO-ANSWER │
  1040.     └───────────────────┘
  1041.  
  1042.     This command will transmit the modem auto-answer command string
  1043.     to the modem.  This command instructs the modem to answer the
  1044.     phone after a certain number of rings (one ring by default).
  1045.  
  1046.     The commands sent to the modem can be altered by choosing modem
  1047.     settings from the Modem menu, or by pressing ALT-O.
  1048.  
  1049.     ┌────────────────┐
  1050.     │ MANUAL DIALING │
  1051.     └────────────────┘
  1052.  
  1053.     This command will prompt you to enter the telephone number to
  1054.     dial.  You may enter any digits from 0-9.  Hyphens are ignored.
  1055.     If you need to obtain a delay before continuing the rest of the
  1056.     phone number, enter a comma (,) for a 1/2 second pause. After
  1057.     entering the phone number, the DIALING window will appear showing
  1058.     you the current status of RIPterm as it dials the modem.
  1059.  
  1060. ┌────────────────────────────────────────────────────────────────────┐
  1061. │                   2.1.2.4 ■ THE "TRANSFER" MENU                    │
  1062. └────────────────────────────────────────────────────────────────────┘
  1063.  
  1064. This menu contains options for transferring files TO (downloading) or
  1065. FROM (uploading) your system.  These commands make use of File
  1066. Transfer Protocols (see below).
  1067.  
  1068.     ┌─────────────────┐
  1069.     │ DOWNLOAD A FILE │
  1070.     └─────────────────┘
  1071.  
  1072.     This command downloads (receives) a file from the host to your
  1073.     system.  This is done by what's called a "protocol" transfer.  A
  1074.     protocol is like a language that humans speak.  There are a
  1075.     number of languages like French, English, and Italian.  If two
  1076.     people are speaking in different languages, the net result is
  1077.     that no communication occurs.  The same goes for protocols.  Both
  1078.     the host and the terminal (RIPterm) must use the same protocol if
  1079.     they are to communicate properly.
  1080.  
  1081.     To download a file, instruct the host which file you want to
  1082.     transfer. Select a protocol from the menu of available protocols.
  1083.     When the host says "Ready to download..." or "Ready to send...",
  1084.     choose the download option of RIPterm and select the same
  1085.     protocol that you chose on the host.  Enter a filename to save to
  1086.     your local hard disk and the file transfer will commence.  When
  1087.     the transfer is done, you will be returned to terminal mode and
  1088.     the file will either exist on your hard disk, or will be
  1089.     incomplete or missing entirely if an error occurred.
  1090.  
  1091.     The currently supported protocols are:
  1092.  
  1093.          X-Modem (checksum)
  1094.          X-Modem (CRC)
  1095.          X-Modem-1K
  1096.          X-Modem-G-1K
  1097.          Y-Modem-Batch
  1098.          Y-Modem-G
  1099.          Z-Modem
  1100.          Kermit
  1101.          ASCII (text files only!)
  1102.  
  1103.     ┌───────────────┐
  1104.     │ UPLOAD A FILE │
  1105.     └───────────────┘
  1106.  
  1107.     This command upload (send) a file to the host from your system.
  1108.     This is done by what's called a "protocol" transfer.  A protocol
  1109.     is like a language that humans speak.  There are a number of
  1110.     languages like French, English, and Italian.  If two people are
  1111.     speaking in different languages, the net result is that no
  1112.     communication occurs. The same goes for protocols.  Both the host
  1113.     and the terminal (RIPterm) must use the same protocol if they are
  1114.     to communicate properly.
  1115.  
  1116.     To upload a file, instruct the host to upload, and give the host
  1117.     a filename.  Select a protocol from the menu of available
  1118.     protocols.  When the host says "Ready to upload..." or "Ready to
  1119.     receive...", choose the upload option of RIPterm and select the
  1120.     corresponding protocol that you chose on the host.  Enter a
  1121.     filename to send from your local hard disk and the file transfer
  1122.     will begin.  When the transfer is done, you will be returned to
  1123.     terminal mode and if there were no errors in transmission, the
  1124.     file will exist on the host.
  1125.  
  1126.     The currently supported protocols are:
  1127.  
  1128.          X-Modem (checksum)
  1129.          X-Modem (CRC)
  1130.          X-Modem-1K
  1131.          X-Modem-G-1K
  1132.          Y-Modem-Batch
  1133.          Y-Modem-G
  1134.          Z-Modem
  1135.          Kermit
  1136.          ASCII (text files only!)
  1137.  
  1138.     ┌───────────────────────┐
  1139.     │ ASCII UPLOAD SETTINGS │
  1140.     └───────────────────────┘
  1141.  
  1142.     This option modifies the default settings for ASCII (text)
  1143.     uploads.  Some hosts are picky about how fast they can take text
  1144.     data being uploaded to them. With this in mind, you can set a
  1145.     short delay in between each line of text sent to the host, and/or
  1146.     you can set a delay in between each character sent to the host.
  1147.     Fine tuning this can make ASCII text uploads fast and the most
  1148.     optimized they can be for the host you call.
  1149.  
  1150. ┌────────────────────────────────────────────────────────────────────┐
  1151. │                     2.1.2.5 ■ THE "DATA" MENU                      │
  1152. └────────────────────────────────────────────────────────────────────┘
  1153.  
  1154.     ┌─────────────────┐
  1155.     │ CREATE VARIABLE │
  1156.     └─────────────────┘
  1157.  
  1158.     This option enters a piece of information into the RIPterm
  1159.     database.  This information will be saved for future use by
  1160.     either yourself or by a host.  You may store just about any piece
  1161.     of information in this database.  Each piece of information is
  1162.     associated with a "name".  Any information entered must be from
  1163.     1-60 characters in length.  The name of the information (also
  1164.     called the variable name), is from 3-12 characters in length.  An
  1165.     example of this might be:
  1166.  
  1167.         Variable        Information Stored in variable
  1168.         --------------  ------------------------------
  1169.         FIRST_NAME      John
  1170.         LAST_NAME       Doe
  1171.         ADDRESS         123 Anywhere Street
  1172.         PHONE_NUMBER    555-1212
  1173.  
  1174.     You may choose to save a data variable either to internal memory,
  1175.     or to the permanent database.  This database is "indexed" for
  1176.     high speed access of information.  In the event that the Index
  1177.     becomes corrupted due to a power failure or something of that
  1178.     nature, it will be automatically re-indexed for you.
  1179.  
  1180.     ┌────────────────┐
  1181.     │ SHOW VARIABLES │
  1182.     └────────────────┘
  1183.  
  1184.     This option displays all text variables that have been stored to
  1185.     the local RIPTERM.DB database file.  All variables are listed to
  1186.     the current text window, but are not sent to the host.  This
  1187.     allows you to see what is currently in your database.
  1188.  
  1189.     NOTE: The variables are appended to the scrollback buffer.  You
  1190.           can view them by selecting text scrollback from the
  1191.           Options menu, or pressing ALT-B.
  1192.  
  1193.     ┌────────────────────┐
  1194.     │ BUILT-IN VARIABLES │
  1195.     └────────────────────┘
  1196.  
  1197.     This displays the contents of all text variables that are built
  1198.     into RIPterm.  Some variables are pre-defined in the sense that
  1199.     RIPterm doesn't need you to instruct it with information.  Among
  1200.     the various pre-defined variables are things like $DATE$, $TIME$,
  1201.     and other such variables that change frequently.  Some variables
  1202.     do not contain valid text data due to their nature.  These might
  1203.     include variables like $SBARON$, or $SBAROFF$ which turn display
  1204.     or hide the Status Bar.  When listing these variables, the
  1205.     contents are listed as blank.
  1206.  
  1207.     NOTE: The variables are appended to the scrollback buffer.  You
  1208.           can view them by selecting text scrollback from the
  1209.           Options menu, or pressing ALT-B.
  1210.  
  1211.     ┌───────────────┐
  1212.     │ DATA SECURITY │
  1213.     └───────────────┘
  1214.  
  1215.     This option gives you control over host data queries to your
  1216.     system.  This option defaults to ON, giving you the ability to
  1217.     scrutinize any queries by the host to ask your system for a piece
  1218.     of information.  This does not apply to pre-defined text
  1219.     variables, just variables that contain data that you've entered.
  1220.  
  1221.     How does this apply to you?  Well, RIPscrip has the inherent
  1222.     ability to pop-up dialog boxes onto your screen asking you for a
  1223.     piece of information.  Depending on the request, this information
  1224.     might be stored to your local RIPterm database for future use (by
  1225.     the same host, or potentially another).  This option exists so
  1226.     that if a host asks your terminal for a piece of information, you
  1227.     have the ability to intervene (i.e., prevent the information from
  1228.     being sent).  This override feature is for security purposes in
  1229.     the event that your database contains sensitive information that
  1230.     you do not want to be given out without your explicit consent.
  1231.  
  1232. ┌────────────────────────────────────────────────────────────────────┐
  1233. │                     2.1.3 ■ HELP ON THE MENUS                      │
  1234. └────────────────────────────────────────────────────────────────────┘
  1235.  
  1236. Selecting the "Pull-Down Menu Help" option from the PROJECT menu
  1237. allows you to view help information on the various menu options.  A
  1238. window will appear instructing you to select a pull-down menu option
  1239. for help.  Simply click on the right mouse button and pull down the
  1240. desired menu.  Select an option, and a Help Screen will appear on
  1241. that item.  When finished, press the <ESC> key to exit "Menu Help"
  1242. mode.  You may also select menu options via the keyboard by using the
  1243. F10 key to activate the menu system.
  1244.  
  1245. ┌────────────────────────────────────────────────────────────────────┐
  1246. │                  2.1.4 ■ MODEM SETUP INFORMATION                   │
  1247. └────────────────────────────────────────────────────────────────────┘
  1248.  
  1249. When you choose the Modem Options feature, a dialog box appears to
  1250. edit many of the available modem settings that are a part of
  1251. RIPterm.  The dialog box looks similar to the following:
  1252.  
  1253. ╔════════════════════════════════════════════════════════════════════╗
  1254. ║                            Modem Options                           ║
  1255. ║              ┌─────────────────────────────────────────────────┐   ║
  1256. ║   Modem Init │ AT E1 V1 X4^M                                   │   ║
  1257. ║              ├─────────────────────────────────────────────────┤   ║
  1258. ║  Auto Answer │ AT S0=1^M                                       │   ║
  1259. ║              ├─────────────────────────────────────────────────┤   ║
  1260. ║  Modem Reset │ AT Z^M                                          │   ║
  1261. ║              ├────┬────────────────────────────────────────────┘   ║
  1262. ║  Redial Time │ 30 │  ┌───────────┐  ┌───────────┐  ┌───────────┐   ║
  1263. ║              └────┘  │ Comm Port │  │ Stop Bits │  │ Baud Rate │   ║
  1264. ║                      ├───────────┤  ├───────────┤  ├───────────┤   ║
  1265. ║     XON/XOFF  ■      │   COM1  X │  │  1 bit  X │  │     300 ■ │   ║
  1266. ║      RTS/CTS  ■      │   COM2  ■ │  │  2 bits ■ │  │    1200 ■ │   ║
  1267. ║                      │   COM3  ■ │  └───────────┘  │    2400 X │   ║
  1268. ║   Touch Tone  ■      │   COM4  ■ │                 │    4800 ■ │   ║
  1269. ║    Use Modem  ■      └───────────┘  ┌───────────┐  │    9600 ■ │   ║
  1270. ║    Add CR/LF  ■      ┌───────────┐  │   Parity  │  │  19,200 ■ │   ║
  1271. ║  ┌────────────┐      │ Data Bits │  ├───────────┤  │  38,400 ■ │   ║
  1272. ║  │     OK     │      ├───────────┤  │   None  X │  │  57,600 ■ │   ║
  1273. ║  ├────────────┤      │  8 bits X │  │    Odd  ■ │  │ 115,200 ■ │   ║
  1274. ║  │   CANCEL   │      │  7 bits ■ │  │   Even  ■ │  └───────────┘   ║
  1275. ║  └────────────┘      └───────────┘  └───────────┘                  ║
  1276. ╚════════════════════════════════════════════════════════════════════╝
  1277.  
  1278. This dialog box is for modifying your modem configuration.  You may
  1279. alter the modem initialization commands, the auto-answer string and
  1280. the modem reset command string.  These options use standard
  1281. Hayes-compatible modem commands.  If you wish to insert a "pause"
  1282. into the command, simply insert a comma (,).
  1283.  
  1284. In addition to modem commands, you may set the COM port, data bits,
  1285. stop bits, parity, and baud rate.  Standard settings are 8 data bits,
  1286. 1 stop bit and NO parity (8N1), or 7 data bits, 1 stop bit and EVEN
  1287. parity (7E1).  Additional options allow you to specify touch tone or
  1288. rotary (pulse) dialing, the number of seconds to wait for a
  1289. connection (redial time), whether to add CR/LF, and whether RIPterm
  1290. is connected directly to a modem or not.
  1291.  
  1292. To alter the serial port IRQ settings, choose the interrupt setup
  1293. option from the modem menu.
  1294.  
  1295. These settings are part of the setup, so once you alter them, you
  1296. should choose the SAVE SETUP option from the Modem menu.
  1297.  
  1298. ┌────────────────────────────────────────────────────────────────────┐
  1299. │                  2.1.4.1 ■ MODEM COMMAND STRINGS                   │
  1300. └────────────────────────────────────────────────────────────────────┘
  1301.  
  1302. Modem command strings are how you configure RIPterm to work with the
  1303. wide variety of modem on the market.  All modem commands begin with
  1304. an "AT", short for 'ATtention'.
  1305.  
  1306. You may specify control characters in a modem command string by
  1307. preceding the character with a caret (^).  For example, a CTRL-C
  1308. would be ^C.
  1309.  
  1310. Each modem command string should end with a ^M (carriage return), as
  1311. shown in the Modem Options dialog box above.
  1312.  
  1313. For more information on modem commands, consult your modem's manual.
  1314.  
  1315. ┌───────────────────┐
  1316. │ MODEM INIT STRING │
  1317. └───────────────────┘
  1318.  
  1319. This field is the modem command that is sent to the modem when
  1320. RIPterm starts up.  All modem commands begin with an "AT", short for
  1321. 'ATtention'.
  1322.  
  1323. ┌──────────────────────────┐
  1324. │ MODEM AUTO-ANSWER STRING │
  1325. └──────────────────────────┘
  1326.  
  1327. This modem command is what would be sent to the modem to set it for
  1328. "auto-answer" mode.  Auto-answer means that the modem will answer the
  1329. phone automatically when it rings.
  1330.  
  1331. ┌────────────────────┐
  1332. │ MODEM RESET STRING │
  1333. └────────────────────┘
  1334.  
  1335. This is the modem command string that is sent when the modem needs to
  1336. be reset.  This may be necessary if you "hang-up" the modem, abort a
  1337. dial attempt, or exit RIPterm.  For most modems, this command is Z,
  1338. which would be entered as "ATZ^m".
  1339.  
  1340. ┌────────────────────────────────────────────────────────────────────┐
  1341. │                    2.2 ■ THE DIALING DIRECTORY                     │
  1342. └────────────────────────────────────────────────────────────────────┘
  1343.  
  1344. When you choose the "Dialing Directory" option, a dialog box similar
  1345. to the following will appear:
  1346.  
  1347. ╔═══════════════════════════════════════════════════════════════════╗
  1348. ║                   Dialing Directory: RIPTERM.PHO                  ║
  1349. ╟───────────────────────────────────────────────────────────────────╢
  1350. ║ ┌─────────────────────────────────────────────────────────────┬─┐ ║
  1351. ║ │  1.  ArenaBBS            1-714-840-3520     2400  8N1  COM1 ││ ║
  1352. ║ │  2.  RIP Demo Midwest    1-708-978-2777    19200  8N1  COM2 ├─┤ ║
  1353. ║ │  3.  Nova Central        1-714-840-8641     9600  8N1  COM1 ││ ║
  1354. ║ │  4.  Galacticomm BBS     1-305-583-7808     9600  8N1  COM1 ││ ║
  1355. ║ │  5.  deltaComm BBS       1-919-481-9399    19200  8N1  COM1 ├─┤ ║
  1356. ║ │  6.  Searchlight BBS     1-516-689-2566    19200  8N1  COM1 ├─┤ ║
  1357. ║ │  7.  Synchronet BBS      1-714-529-9547    19200  8N1  COM1 ││ ║
  1358. ║ │  8.  Wildcat BBS         1-805-395-0650     9600  8N1  COM1 ││ ║
  1359. ║ │  9.  PC Board BBS        1-801-261-8976    19200  8N1  COM1 ├─┤ ║
  1360. ║ │ 10.  E-Soft (TBBS)       1-303-699-8222     9600  8N1  COM1 ││ ║
  1361. ║ └─────────────────────────────────────────────────────────────┴─┘ ║
  1362. ║      ┌────────┬────────┬────────┬────────┬────────┬────────┐      ║
  1363. ║      │  Edit  │  Mark  │ Unmark │ SaveAs │  Load  │  Find  │      ║
  1364. ║      ├────────┼────────┼────────┼────────┼────────┼────────┤      ║
  1365. ║      │  Dial  │ Cancel │  Kill  │  Print │ Toggle │  Help  │      ║
  1366. ║      └────────┴────────┴────────┴────────┴────────┴────────┘      ║
  1367. ╚═══════════════════════════════════════════════════════════════════╝
  1368.  
  1369. At the top of the dialing directory dialog box, the filename of the
  1370. dialing directory is displayed (e.g., "RIPTERM.PHO").  Whenever you
  1371. change dialing directory files, this will change to reflect the
  1372. current file in use.
  1373.  
  1374. In the middle of the dialog box is a listing of available hosts to
  1375. choose from.  Ten hosts are displayed at any once, and each directory
  1376. can contain up to 100 entries.  You can scroll through the available
  1377. hosts quickly by using the UP/DOWN arrows on the right of the
  1378. display.  Just underneath the UP arrow, and above the DOWN arrow are
  1379. two different buttons; these are used for PGUP, and PGDN.  The UP
  1380. ARROW, DOWN ARROW, PGUP, PGDN, HOME, and END keys work intuitively.
  1381.  
  1382. Any one of the ten lines in the window can be highlighted by pressing
  1383. ALT-1 through ALT-0 (10).  Any previously highlighted entries will be
  1384. un-highlighted and the given line in the window will be highlighted.
  1385. If you simultaneously hold down the SHIFT key while pressing ALT-1
  1386. through ALT-0, then the associated line will be highlighted in
  1387. addition to any previously highlighted lines (highlight merge).  Do
  1388. not confuse ALT-1 through ALT-0 with the numbers listed on the left
  1389. side of the window.  The numbers in the window are the entries in the
  1390. entire directory, not the window line number.  Pressing an ALT-1
  1391. through ALT-0 will highlight the window line number.  To highlight a
  1392. specific directory entry, see the MARK mode below.
  1393.  
  1394. Each host displays an entry number, the host name, telephone number,
  1395. baud rate, data bits (7 or 8), parity (E, N, O), stop bits (1 or 2),
  1396. and the COM port (COM1 - COM4).
  1397.  
  1398. There are twelve buttons at the bottom of the dialog box to choose
  1399. from.  They function as follows:
  1400.  
  1401.     ┌──────┐
  1402.     │ EDIT │
  1403.     └──────┘
  1404.  
  1405.     Clicking this button edits one or more dialing directory
  1406.     entries.  At least one entry must be highlighted (marked).  When
  1407.     clicked, a dialog box will appear for each host highlighted
  1408.     allowing you to edit each host's characteristics.  See the next
  1409.     section (2.2.1) for details on the Dialing Directory Editor.
  1410.  
  1411.     ┌──────┐
  1412.     │ DIAL │
  1413.     └──────┘
  1414.  
  1415.     Selecting DIAL calls one or more selected directory entries.  If
  1416.     more than one entry is highlighted, they will be dialed in
  1417.     numerical order.  If a connection is established to any host, it
  1418.     will be un-highlighted in the dialing directory so that later
  1419.     re-entry into the directory will allow you to dial the remaining
  1420.     hosts.  This option is automatically highlighted as the "default
  1421.     option" if at least one directory entries is highlighted.
  1422.  
  1423.     ┌──────┐
  1424.     │ MARK │
  1425.     └──────┘
  1426.  
  1427.     This option will mark (highlight) one or more dialing directory
  1428.     entries for subsequent action.  When chosen, a dialog box will
  1429.     appear allowing you enter information.  In this dialog box, you
  1430.     can enter one or more numbers indicating which directory entry(s)
  1431.     to highlight.  There are a number of options you may choose from
  1432.     for highlighting entries.  Some examples are:
  1433.  
  1434.         Examples:
  1435.         ---------
  1436.             1            ... highlight entry 1
  1437.             1, 2, 3      ... highlight entries 1, 2 and 3
  1438.             1 2 3        ... highlight entries 1, 2 and 3
  1439.             1;2;3        ... highlight entries 1, 2 and 3
  1440.             1-10         ... highlight entries 1 through 10
  1441.             15-          ... highlight entries 15 to the end (100)
  1442.             -5           ... highlight from Start (1) to entry 5
  1443.             -            ... highlight ALL entries
  1444.             1-5, 10, 95- ... highlight 1-5, 10 and 95-100
  1445.  
  1446.     In addition, you can also specify a "Mark Merge".  This mode
  1447.     allows you to combine your Marked entries with any entries that
  1448.     are already marked.  To use Mark Merge mode, enter a plus sign
  1449.     (+) as the first character.  For example, if entries 3 and 5 are
  1450.     highlighted, and you mark "+ 10-15", then entries 3, 5, and 10-15
  1451.     will be highlighted.
  1452.  
  1453.     One final option is the Mark Exclude mode.  This mode is similar
  1454.     to Mark Merge, except that all entries EXCEPT those highlighted
  1455.     are marked.  In other words, anything that you would think would
  1456.     be highlighted, would not be, and anything that shouldn't be
  1457.     highlighted, will be!  This odd way of doing things can become
  1458.     very handy when combined with some of the other options in the
  1459.     dialing directory.  To choose Mark Exclude mode, specify an
  1460.     exclamation mark (!) as the first character.
  1461.  
  1462.     You can combine Mark Merge, and Mark Exclude modes together.  To
  1463.     do this, enter the sequence "+!" as the first two characters in
  1464.     the dialog box.
  1465.  
  1466.     Mark Mode will be automatically be chosen if you begin typing
  1467.     something that appears to be a mark sequence.  In other words,
  1468.     you do not have to select Mark mode in order to Mark entries. For
  1469.     example, from the dialing directory dialog box, simply typing "1"
  1470.     will bring up the Mark dialog and place "1" in the editing field
  1471.     automatically and allow you to continue typing in your Mark
  1472.     expression.
  1473.  
  1474.     ┌────────┐
  1475.     │ CANCEL │
  1476.     └────────┘
  1477.  
  1478.     This will abort the dialing directory window.  Any previously
  1479.     highlighted entries will remain highlighted the next time you
  1480.     enter the directory.  You are returned to the terminal screen.
  1481.  
  1482.     ┌────────┐
  1483.     │ UNMARK │
  1484.     └────────┘
  1485.  
  1486.     This will un-highlight any previously highlighted directory
  1487.     entries.  You may also press the Space Bar to choose this option.
  1488.  
  1489.     ┌──────┐
  1490.     │ KILL │
  1491.     └──────┘
  1492.  
  1493.     This option will delete all previously highlighted directory
  1494.     entries.  You will be prompted to make absolutely sure that you
  1495.     truly wish to erase the entries.  All calling statistics for
  1496.     those entries will be erased as well.  Once an option is killed,
  1497.     it is permanently deleted.  If no entries are highlighted, this
  1498.     option has no affect.
  1499.  
  1500.     ┌─────────┐
  1501.     │ SAVE AS │
  1502.     └─────────┘
  1503.  
  1504.     This option will save either the entire dialing directory, or
  1505.     just the highlighted entries to another directory file.  This
  1506.     allows you to create new directory files quickly and easily for
  1507.     specific purposes. If one or more entries are highlighted, only
  1508.     those entries are copied to the new file.  If no entries are
  1509.     highlighted, then the entire dialing directory file is copied.
  1510.     You will be prompted to enter the destination filename.
  1511.  
  1512.     If the destination file exists, it is checked to see if it is a
  1513.     RIPterm dialing directory file.  If it is, you will be prompted
  1514.     to either merge the highlighted entries into destination file, or
  1515.     to overwrite the file with just the highlighted entries.
  1516.  
  1517.     In the event that the destination file becomes full, a message to
  1518.     the effect will be displayed informing you how many entries
  1519.     couldn't be copied.
  1520.  
  1521.     This "directory merge" feature is unique to RIPterm.
  1522.  
  1523.     NOTE: Modifications to the dialing directory are automatically
  1524.           saved to the current directory file.  You do not need to
  1525.           choose SAVE AS every time you add or edit an entry.
  1526.  
  1527.     ┌───────┐
  1528.     │ PRINT │
  1529.     └───────┘
  1530.  
  1531.     This prints the contents of the dialing directory (or highlighted
  1532.     entries) to either a disk file, or to a printer attached to LPT1.
  1533.     Choosing the disk option will prompt you for a filename.
  1534.  
  1535.     Before printing/saving occurs, you will be asked what type of
  1536.     output you wish.  You have two choices: TABLE format, or DETAILED
  1537.     BREAKDOWN.  Table format will print one entry per line, formatted
  1538.     for an 80-column display.
  1539.  
  1540.     System Name          System Phone Number
  1541.     ===========================================  continued next line
  1542.     ArenaBBS (TeleGrafix 1-714-840-3520
  1543.  
  1544.                                 Baud COM COM       Last  Mod
  1545.                                 Rate Vals # Calls  Call   ? HostID
  1546.     continued from previous     ====================================
  1547.                                 2400  8N1 1   39  1/30/93 Y ARENA
  1548.  
  1549.     Specifying detailed mode will output a multi-line record for each
  1550.     entry. The format of detailed breakdown mode is similar to the
  1551.     following:
  1552.  
  1553.           Host Name: ArenaBBS (TeleGrafix)
  1554.         Telephone #: 1-714-840-3520
  1555.           Baud Rate: 2400
  1556.           Data Bits: 8
  1557.              Parity: NONE
  1558.           Stop Bits: 1
  1559.            COM Port: 1
  1560.             Host ID: ARENA
  1561.         Connections: 39
  1562.           Last Call: 01/30/93
  1563.  
  1564.     ┌──────┐
  1565.     │ LOAD │
  1566.     └──────┘
  1567.  
  1568.     This option allows you to load up another dialing directory file.
  1569.     The current directory file will be closed and the specified file
  1570.     will be loaded in its place.  All entries are un-highlighted, and
  1571.     the window is automatically redisplays the newly loaded entries.
  1572.  
  1573.     ┌────────┐
  1574.     │ TOGGLE │
  1575.     └────────┘
  1576.  
  1577.     This option alters what information is displayed in the dialing
  1578.     directory window.  By default, the following information is
  1579.     displayed on each line in the window:
  1580.  
  1581.         Entry #
  1582.         Host Name
  1583.         Phone Number
  1584.         Baud Rate
  1585.         Data Bits, Parity and Stop Bits (e.g., 8N1)
  1586.         Communications Port (e.g., COM1)
  1587.  
  1588.     When you choose the toggle option, the information displayed will
  1589.     be changed to the following:
  1590.  
  1591.         Entry #
  1592.         Host Name
  1593.         Total # of calls
  1594.         Last call date
  1595.         Directory ID (see below)
  1596.         Modem or Serial-Port connection
  1597.  
  1598.     This is a simple toggle.  Each time you choose this option, the
  1599.     information displayed will change to the opposite mode.
  1600.  
  1601.     Your favorite toggle setting can be saved to your permanent
  1602.     RIPterm setup.  To do this, choose the toggle mode you like the
  1603.     best, exit the dialing directory, then choose Save Setup.
  1604.  
  1605.     ┌──────┐
  1606.     │ FIND │
  1607.     └──────┘
  1608.  
  1609.     This option will highlight zero or more entries that contain the
  1610.     specified search text.  Once you choose this option, a dialog box
  1611.     will appear prompting you to enter a piece of text to search for
  1612.     throughout the dialing directory.  Any entries that contain the
  1613.     chosen text will automatically be highlighted.  Search is not
  1614.     case sensitive.  The host name, phone number and directory-ID
  1615.     fields are searched for the text.  Text can appear anywhere in
  1616.     any of these three fields and will still be found.
  1617.  
  1618.     You may choose Find Merge mode, or Find Exclude mode (or both)
  1619.     exactly the same way as you can with the Mark mode.  The command
  1620.     characters (+ and !) are not added to the search string, and must
  1621.     be the first characters specified in the search string.  Merge
  1622.     mode can be quite useful if you wish to highlight all entries in
  1623.     a specific area code, or that contain a common theme (like
  1624.     "business", or "daily").
  1625.  
  1626.     ┌──────┐
  1627.     │ HELP │
  1628.     └──────┘
  1629.  
  1630.     This option displays the help screen for the dialing directory.
  1631.  
  1632. ┌────────────────────────────────────────────────────────────────────┐
  1633. │             2.2.1 ■ EDITING DIALING DIRECTORY ENTRIES              │
  1634. └────────────────────────────────────────────────────────────────────┘
  1635.  
  1636.     When you choose to edit one or more dialing directory entries, a
  1637.     dialog box similar to the following will appear on your screen
  1638.     allowing you to edit the various entries:
  1639.  
  1640.         ╔════════════════════════════════════════════════════╗
  1641.         ║          ┌─────────────────────────┐ ┌───────────┐ ║
  1642.         ║     Name │Host name goes here...   │ │    Baud   │ ║
  1643.         ║          ├─────────────────────────┤ ├───────────┤ ║
  1644.         ║   Number │1-714-555-1212           │ │     300 ■ │ ║
  1645.         ║          ├────────────┬────────────┘ │    1200 ■ │ ║
  1646.         ║       ID │Directory   │          ┌─┐ │    2400 X │ ║
  1647.         ║          └────────────┘    Modem │X│ │    4800 ■ │ ║
  1648.         ║                                  └─┘ │    9600 ■ │ ║
  1649.         ║   ┌────────┐ ┌──────────┐ ┌────────┐ │  19,200 ■ │ ║
  1650.         ║   │  Port  │ │Stop Bits │ │ Parity │ │  38,400 ■ │ ║
  1651.         ║   ├────────┤ ├──────────┤ ├────────┤ │  57,600 ■ │ ║
  1652.         ║   │ COM1 X │ │ 1 bit  X │ │ NONE X │ │ 115,200 ■ │ ║
  1653.         ║   │ COM2 ■ │ │ 2 bits ■ │ │ EVEN ■ │ └───────────┘ ║
  1654.         ║   │ COM3 ■ │ └──────────┘ │ ODD  ■ │ ┌───────────┐ ║
  1655.         ║   │ COM4 ■ │              └────────┘ │ Data Bits │ ║
  1656.         ║   └────────┘                         ├───────────┤ ║
  1657.         ║ ┌──────────┐┌──────────┐┌──────────┐ │  7 bits ■ │ ║
  1658.         ║ │    OK    ││  CANCEL  ││   HELP   │ │  8 bits X │ ║
  1659.         ║ └──────────┘└──────────┘└──────────┘ └───────────┘ ║
  1660.         ╚════════════════════════════════════════════════════╝
  1661.  
  1662.     The significance of each of these fields are described below:
  1663.  
  1664.     ┌──────┐
  1665.     │ NAME │
  1666.     └──────┘
  1667.  
  1668.     The name field is the name of the host that will appear in the
  1669.     dialing directory window.  This is the name that will be
  1670.     displayed to you whenever you dial the host, and is used in
  1671.     general to describe the host.  You are allowed 25 characters
  1672.     for the host name.
  1673.  
  1674.     ┌────────┐
  1675.     │ NUMBER │
  1676.     └────────┘
  1677.  
  1678.     This is the telephone number (if any) that is used to dial the
  1679.     host.  You are allowed up to 25 characters for the number.  Valid
  1680.     characters are digits 0-9, hyphens and parenthesis (if your modem
  1681.     permits it).  You may also enter a comma (,) to indicate a
  1682.     half-second pause.  This pause is handled by your modem, not by
  1683.     RIPterm.  On some modems, this pause may be two or three seconds.
  1684.     Check your modem's documentation to determine the delay value.
  1685.  
  1686.     Some examples of Telephone Numbers are as follows:
  1687.  
  1688.                555-1212 ... Dial 555-1212
  1689.          1-714-555-1212 ... Dial (714) 555-1212
  1690.              9,555-1212 ... Dial a 9, then pause, then 555-1212
  1691.  
  1692.     ┌────┐
  1693.     │ ID │
  1694.     └────┘
  1695.  
  1696.     This field takes a bit more explaining than the other fields in
  1697.     the directory editor.  Each entry in the directory has the
  1698.     ability to have a separate sub-directory associated with it.
  1699.     This is used mainly when RIPscrip graphics are being viewed on
  1700.     the host. Any icon (.ICN, .MSK, .HIC) or RIPscrip (.RIP) files
  1701.     that are received by the host should be placed in the designated
  1702.     sub-directory.  This in effect, helps keep your icons separated
  1703.     from each other.
  1704.  
  1705.     If you omit a directory name in this field, and you dial into a
  1706.     RIPscrip host that requires icons or RIPscrip files, RIPterm will
  1707.     look for them automatically in the ICONS\ sub-directory.  It is
  1708.     recommended that you keep host specific files in their proper
  1709.     sub-directories for elegant file maintenance.
  1710.  
  1711.     You do not need to create the sub-directory yourself.  The first
  1712.     time that you call into that host via the dialing directory,
  1713.     RIPterm will check the ID field, and if it is non-blank, will
  1714.     automatically create the sub-directory if it doesn't exist.
  1715.  
  1716.     If the ID field is non-blank, indicating a sub-directory should
  1717.     be used for that specific host, RIPterm will check in that
  1718.     directory first for any necessary icons or RIPscrip files.  If
  1719.     the needed file is not found in that sub-directory, RIPterm will
  1720.     check the ICONS\ sub-directory afterward to see if it is there.
  1721.     This facilitates the concept of "file override".
  1722.  
  1723.     This "file override" is best explained by an example.  Let's say
  1724.     you call several different RIPscrip hosts.  Each of them have
  1725.     numerous icons that they use for their host.  Now as you are
  1726.     probably aware, each sysop of each host thinks of his host as the
  1727.     only host in the world.  With that in mind, they would probably
  1728.     not give a great amount of thought to the names that they give
  1729.     their icon or RIPscrip files (i.e., not considering that other
  1730.     hosts might have files with the same names).  Files like
  1731.     EMAIL.ICN or FILES.ICN would be use on nearly any host!  If all
  1732.     these files were located in the same directory, only the very
  1733.     latest installed files would be used when you call a host!  In
  1734.     other words, when you call host XYZ, you might see host ABC's
  1735.     EMAIL icon! This is obviously not how it should work.  With this
  1736.     in mind, keeping files in separate sub-directories resolves this
  1737.     problem quite nicely.  Even if a sysop chooses to use the
  1738.     standard RIPterm EMAIL icon, he can do that too. All he has to do
  1739.     is NOT provide you with his own EMAIL icon.  RIPterm will find
  1740.     the correct file for you automatically.  It would first check
  1741.     host XYZ's directory (presumably directory "XYZ\"), and after
  1742.     finding that the file is not there, would check the ICONS\
  1743.     sub-directory and find it there.  In this fashion, the sysop has
  1744.     the ability to override standard icons with his own without
  1745.     affecting the standard icons in any way.
  1746.  
  1747.     Keep in mind, that if you dial a host by issuing modem commands
  1748.     directly (not using the dialing directory), then the correct
  1749.     directory may not be used since RIPterm has no way of knowing
  1750.     which dialing directory entry you are calling.  In other words,
  1751.     you should use the dialing directory to call ALL RIPscrip hosts!
  1752.  
  1753.     NOTE: RIPterm supports a "block protocol" mode for hosts that
  1754.           can support it.  This mode allows the host to send files to
  1755.           your computer for subsequent use.  Any files received in
  1756.           this mode are automatically placed in the proper host ID
  1757.           directory. If no host ID field is specified, then the
  1758.           ICONS\ sub-directory is chosen as the destination
  1759.           sub-directory.
  1760.  
  1761.     ┌───────┐
  1762.     │ MODEM │
  1763.     └───────┘
  1764.  
  1765.     This button is a toggle-type button.  It can be either ON or OFF.
  1766.     If it is enabled (the default), then when this entry is dialed,
  1767.     it will be assumed that it is calling the host via a modem
  1768.     device.  If it is off, then RIPterm will assume that the host is
  1769.     connected to your computer via a direct serial connection.
  1770.  
  1771.     If the modem option is activated, RIPterm will monitor the modem
  1772.     for a "CONNECT" message of some kind.  Other messages that can
  1773.     affect the dialing process are "ERROR", "NO DIALTONE", "VOICE" or
  1774.     "BUSY".
  1775.  
  1776.     If this option is inactive, typically, connection is made
  1777.     instantly, and you will be presented with some kind of an intro
  1778.     message.  RIPterm will automatically press <ENTER> to the host to
  1779.     try to activate the connection for you.
  1780.  
  1781.     ┌──────┐
  1782.     │ BAUD │
  1783.     └──────┘
  1784.  
  1785.     This option allows you to specify the baud rate at which the
  1786.     connection should be made (or at least attempted).  Valid baud
  1787.     rates are 300, 1200, 2400, 4800, 9600, 19200, 38400, 57600, and
  1788.     115200 baud.  If a CONNECT message is received indicating a baud
  1789.     rate other than the specified rate, RIPterm will automatically
  1790.     adjust the baud rate on its end to ensure that communication will
  1791.     take place (this is often called "auto-baud detect" mode).
  1792.  
  1793.     ┌──────┐
  1794.     │ PORT │
  1795.     └──────┘
  1796.  
  1797.     This option allows you to specify which communications port will
  1798.     be used to dial the given host.  Valid ports are COM1 through
  1799.     COM4.  Of course, your system must have the given port in order
  1800.     to be able to dial out on it.  Before the host is called, RIPterm
  1801.     will initialize the given port (if it hasn't already) and if
  1802.     everything is OK, will dial the host (or press <ENTER> if it's a
  1803.     non-modem host).
  1804.  
  1805.     ┌───────────┐
  1806.     │ STOP BITS │
  1807.     └───────────┘
  1808.  
  1809.     This option allows you to alter the number of "Stop Bits" that
  1810.     are used for the communications link.  Valid settings are 1 stop
  1811.     bit, or 2 stop bits.  Typically, 1 stop bit will be used for the
  1812.     vast majority of hosts.
  1813.  
  1814.     ┌────────┐
  1815.     │ PARITY │
  1816.     └────────┘
  1817.  
  1818.     This option allows you to alter the parity setting that will be
  1819.     used for a given communications link.  Valid settings are EVEN,
  1820.     ODD or NONE.  The vast majority of hosts in the world use a
  1821.     setting of NONE, for "No Parity".  Situations where you will
  1822.     choose something other than NONE would be if you were calling a
  1823.     mainframe computer, or dialing up via a nationwide network like
  1824.     TymNet, TeleNet, GEnie, CompuServe, or other such X.25-based
  1825.     hosts. If in doubt, try NONE.
  1826.  
  1827.     ┌───────────┐
  1828.     │ DATA BITS │
  1829.     └───────────┘
  1830.  
  1831.     This option allows you to alter the number of data bits that will
  1832.     be used for a given communications link.  Valid settings are 7
  1833.     data bits, or 8 data bits.  You will find that most hosts use 8
  1834.     data bits.  7 data bits are commonly used when calling mainframe
  1835.     computers, or large hosts like TymNet, TeleNet, GEnie,
  1836.     CompuServe, or other nationwide network services that use the
  1837.     X.25 network protocol.  When in doubt, try 8 data bits.  If you
  1838.     get garbled information, try 7.
  1839.  
  1840.     In the last three sub-sections, you've seen settings for data
  1841.     bits, parity, and stop bits.  In nearly 100% of every situation,
  1842.     there are only two combinations of these three values that are
  1843.     used. They are:
  1844.  
  1845.               8 data bits         7 data bits
  1846.                No parity          Even parity
  1847.               1 stop bit          1 stop bit
  1848.               -----------         -----------
  1849.                 8-N-1               7-E-1           <- referred to as
  1850.             eight-none-one      seven-even-one      <- pronounced
  1851.  
  1852.     ┌────┐
  1853.     │ OK │
  1854.     └────┘
  1855.  
  1856.     This will accept any changes you have made and return you to the
  1857.     dialing directory dialog box.  Any changes you made in the editor
  1858.     will be reflected in the dialing directory window.  If you have
  1859.     highlighted multiple entries to edit, then the remaining entries
  1860.     (if any) that haven't been edited will be edited before you are
  1861.     returned to the dialing directory screen.
  1862.  
  1863.     ┌────────┐
  1864.     │ CANCEL │
  1865.     └────────┘
  1866.  
  1867.     This will cancel any modifications you have made in the directory
  1868.     editor.  You will be returned to the dialing director
  1869.     automatically.  If you have chosen to edit multiple directory
  1870.     entries (by highlighting more than one), and there are entries
  1871.     that haven't been edited yet, they will be edited before you are
  1872.     eventually returned to the dialing directory.
  1873.  
  1874.     ┌──────┐
  1875.     │ HELP │
  1876.     └──────┘
  1877.  
  1878.     This option bring up the help screen for the directory editor.
  1879.  
  1880. ┌────────────────────────────────────────────────────────────────────┐
  1881. │    2.2.2 ■ DIALING DIRECTORY CONVERSION UTILITY (DIALCONV.EXE)     │
  1882. └────────────────────────────────────────────────────────────────────┘
  1883.  
  1884. For your convenience, a utility program has been included with
  1885. RIPterm to convert dialing directory files from other popular
  1886. terminal programs to RIPterm format.  This program currently supports
  1887. the conversion of Telix and TeleMate directory files to RIPterm
  1888. format.  Conversion is "one way".  In other words, you cannot convert
  1889. a RIPterm directory file to Telix format, but you can go the other
  1890. way around (Telix to RIPterm conversion).
  1891.  
  1892. Use of DIALCONV is quite simple.  The program will auto-detect what
  1893. type of dialing directory file is to be processed and will
  1894. automatically use the appropriate conversion method necessary for the
  1895. given file.
  1896.  
  1897. To convert a directory file, enter a command similar to:
  1898.  
  1899.     DIALCONV TELIX.FON RIPTERM.PHO
  1900.  
  1901. In the preceding example, DIALCONV would convert the Telix directory
  1902. file TELIX.FON to a RIPterm directory file called RIPTERM.PHO.
  1903. RIPterm uses the extension of .PHO to designate dialing directories.
  1904.  
  1905. All "statistical" data in the source directory file are converted
  1906. into the new RIPterm file.  For example, the last date a host was
  1907. called, and total number of calls you have made to that host are
  1908. converted as well and are made part of the RIPterm directory file. In
  1909. addition, COM port, baud rate and other settings are converted as
  1910. well for your convenience.
  1911.  
  1912. If you wish to simply view the contents of a Telix or TeleMate
  1913. directory file without conversion (to make sure that conversion would
  1914. take place properly), you can choose an optional "view" option for
  1915. DIALCONV by specifying the "-v" switch on the command line.  For
  1916. example, to list out all the valid entries in a Telix directory file
  1917. called TELIX.FON to the screen, enter the following command:
  1918.  
  1919.     DIALCONV -v TELIX.FON
  1920.  
  1921. All entries will be displayed to the screen for you.  Output can be
  1922. captured to a text file if you wish by using the MS-DOS redirection
  1923. feature.  Using the preceding example, let's say you wanted to print
  1924. all entries in the Telix directory file to the text file TELIX.LST,
  1925. enter the following command:
  1926.  
  1927.     DIALCONV -v TELIX.FON >TELIX.LST
  1928.  
  1929. Note the use of the redirection symbol ">" followed by the filename
  1930. to redirect output to.  You could just have easily directed the
  1931. programs output to the Printer with the following command:
  1932.  
  1933.     DIALCONV -v TELIX.FON >PRN
  1934.  
  1935. ┌────────────────────────────────────────────────────────────────────┐
  1936. │               2.2.3 ■ DIALING DIRECTORY FILE FORMAT                │
  1937. └────────────────────────────────────────────────────────────────────┘
  1938.  
  1939. For the technically minded, this section of this document defines the
  1940. internal structure of the RIPterm dialing directory file.  This is
  1941. provided for programmers who wish to create directory maintenance
  1942. utilities.
  1943.  
  1944. A RIPterm dialing directory file is a "flat-file" database with no
  1945. index.  Each record is of fixed length and is stored in numerical
  1946. order from 1-100.  Each entry is exactly 100 bytes in length, so a
  1947. dialing directory file is exactly 10,000 bytes in length.  Blank
  1948. entries are identified by the NAME, PHONE and HOST_ID fields being
  1949. entirely blank (i.e., NULL's).
  1950.  
  1951. The C data structure for each record is as follows:
  1952. ---------------------------------------------------
  1953.  
  1954.     struct phone_entry {
  1955.         char name[25];          /* name of host               */
  1956.         char phone[25];         /* phone number of host       */
  1957.                                 /* -------------------------- */
  1958.         int  com_port;          /* COMx to use (0=default)    */
  1959.         long baud;              /* baud rate to dial at       */
  1960.         char data_bits;         /* data bits (7-8)            */
  1961.         char stop_bits;         /* stop bits (1-2)            */
  1962.         char parity;            /* parity setting             */
  1963.                                 /* -------------------------- */
  1964.         char host_id[13];       /* host-ID (resource filename)*/
  1965.         long total_connects;    /* total # of connections     */
  1966.         int  last_date;         /* last date connected        */
  1967.         int  reserved;          /* reserved field             */
  1968.         char connected_to;      /* 0=modem, 1=computer        */
  1969.         char spare[19];         /* spare space for upgrades   */
  1970.     };                          /* TOTAL SIZE: 100 bytes      */
  1971.  
  1972. The LAST_DATE field is an integer.  This variable uses the MS-DOS
  1973. method of encoding Dates into a 16-bit number.  Consult the MS-DOS
  1974. Programmer's Reference Manual for details on the internal format of
  1975. DOS Dates.
  1976.  
  1977. ┌────────────────────────────────────────────────────────────────────┐
  1978. │                      2.3 ■ DIALING THE MODEM                       │
  1979. └────────────────────────────────────────────────────────────────────┘
  1980.  
  1981. Press <ALT-M> to bring up the phone number dialog box.
  1982.  
  1983. Enter the telephone number you wish to dial.  You may enter any
  1984. numeric digits (0-9).  Hyphens are ignored.  Enter a comma for a 1/2
  1985. second delay (e.g., 9,1-714-555-1212).  You may need to add delays if
  1986. you have to use a special service or a switchboard to obtain an
  1987. outside line dial-tone.
  1988.  
  1989. The dialing window will appear when RIPterm is attempting to dial the
  1990. modem.  On this window will be displayed the number of seconds that
  1991. have elapsed, the time that dialing started, the time of the last
  1992. re-dial attempt, the telephone number and other information about the
  1993. dialing state.
  1994.  
  1995. Pressing <ENTER> will abort the current dialing attempt and start
  1996. over.  Pressing <ESC> or clicking "Cancel" will abort dialing.
  1997.  
  1998. ┌────────────────────────────────────────────────────────────────────┐
  1999. │                     2.4 ■ THE DIALING WINDOW                       │
  2000. └────────────────────────────────────────────────────────────────────┘
  2001.  
  2002. When RIPterm dials a host, it will display a dialog box showing you
  2003. the progress when dialing the host.  The dialog box looks similar to:
  2004.  
  2005. ╔═══════════════════════════════════════════════════════════════════╗
  2006. ║          ┌─────────────────────────────────┐                      ║
  2007. ║     Host │ Host name goes here...          │                      ║
  2008. ║          ├─────────────────────────────────┤           ┌─────┐    ║
  2009. ║  Phone # │ 1-714-555-1212                  │   Attempt │ 005 │    ║
  2010. ║          ├──────────┬───────────┬──────────┤           ├─────┼─┐  ║
  2011. ║  Started │ 08:23:25 │   Current │ 08:31:42 │    Remain │ 10  ││  ║
  2012. ║          ├──────────┴───────────┴──────────┴───────────┴─────┴─┤  ║
  2013. ║  Message │ Host is Busy.  Redialing...                         │  ║
  2014. ║          └─────────────────────────────────────────────────────┘  ║
  2015. ║      ╔════════════╗      ┌────────────┐      ┌────────────┐       ║
  2016. ║      ║   REDIAL   ║      │   CANCEL   │      │   DELETE   │       ║
  2017. ║      ╚════════════╝      └────────────┘      └────────────┘       ║
  2018. ╚═══════════════════════════════════════════════════════════════════╝
  2019.  
  2020. Each field is described more fully in the following sections:
  2021.  
  2022.     ┌──────┐
  2023.     │ HOST │
  2024.     └──────┘
  2025.  
  2026.     This field displays the name of the host that is being dialed.
  2027.     This field may be blank if you choose to dial via the manual
  2028.     dialing method (ALT-M).  If you are dialing by choosing entries
  2029.     from the dialing directory, whatever host name is displayed will
  2030.     be shown in this field when that entry is dialed.
  2031.  
  2032.     ┌─────────┐
  2033.     │ PHONE # │
  2034.     └─────────┘
  2035.  
  2036.     This displays the telephone number that is being used when
  2037.     dialing the designated host.  It is shown in this field exactly
  2038.     as it is transmitted to the modem.
  2039.  
  2040.     ┌─────────┐
  2041.     │ STARTED │
  2042.     └─────────┘
  2043.  
  2044.     This field shows the time that this dialing attempt began. The
  2045.     format of this field is HH:MM:SS.  Whenever a number is dialed,
  2046.     or the dialing window cycles to the next number, this field is
  2047.     updated with the current time that the telephone number is issued
  2048.     to the modem to dial out.
  2049.  
  2050.     ┌─────────┐
  2051.     │ CURRENT │
  2052.     └─────────┘
  2053.  
  2054.     This field displays the current time.  This field will constantly
  2055.     change as the dialing progresses.  It is intended to give you a
  2056.     visual reference to the time, compared to the start time.
  2057.  
  2058.     ┌─────────┐
  2059.     │ MESSAGE │
  2060.     └─────────┘
  2061.  
  2062.     Periodically through the dialing process, various status messages
  2063.     may need to be displayed to give you more information on what is
  2064.     going on.  Of the various messages, you might see things like,
  2065.     "Host is Busy.  Redialing...", or "Time elapsed without
  2066.     connection". This is generally used to tell you what is going on.
  2067.  
  2068.     ┌─────────┐
  2069.     │ ATTEMPT │
  2070.     └─────────┘
  2071.  
  2072.     This shows how many attempts have been tried thus far for this
  2073.     phone number.  If the host is busy, then it will try again after
  2074.     a brief pause.  If you have many hosts "queued" up to dial, then
  2075.     this shows the attempt number only for the given host being
  2076.     dialed at the moment.  Up to 999 attempts will be made before
  2077.     RIPterm stops all dialing attempts to a particular host.
  2078.  
  2079.     ┌────────┐
  2080.     │ REMAIN │
  2081.     └────────┘
  2082.  
  2083.     This message displays how many seconds remain before the current
  2084.     dialing attempt will terminate.  By default, redial time is set
  2085.     to 30 seconds, but this can be changed from within the modem
  2086.     options dialog box.  High speed modems, or long distance calls
  2087.     frequently need more than 30 seconds to complete an outgoing
  2088.     call. To the right of this field are two small arrows, an UP
  2089.     arrow, and a DOWN arrow.  These are for temporarily increasing or
  2090.     decreasing the redial time for the rest of this dialing attempt.
  2091.  
  2092.     ┌────────┐
  2093.     │ REDIAL │
  2094.     └────────┘
  2095.  
  2096.     This button will cause what's commonly known as a "cycle" to
  2097.     occur.  This is used when you have highlighted a number of
  2098.     entries to dial.  By clicking on redial, it will stop calling
  2099.     whichever host is currently being dialed, and will cycle to the
  2100.     next highlighted host in your dialing list and begin to dial that
  2101.     number.  If you are only dialing one host, this will stop the
  2102.     current dialing attempt and re-dial the same number again.
  2103.  
  2104.     ┌────────┐
  2105.     │ CANCEL │
  2106.     └────────┘
  2107.  
  2108.     This option will stop dialing.  You will be returned to the
  2109.     RIPterm session screen.  Any entries in the dialing directory
  2110.     that you were trying to dial will remain highlighted the next
  2111.     time you enter the dialing directory.
  2112.  
  2113.     ┌────────┐
  2114.     │ DELETE │
  2115.     └────────┘
  2116.  
  2117.     This option will remove an entry from your dial list.  What this
  2118.     means is that whatever host is currently being dialed will have
  2119.     its dialing attempt stopped, and then it will be un-highlighted
  2120.     in the dialing directory, then RIPterm will attempt to dial the
  2121.     next highlighted number (if any).  If no more entries are
  2122.     available in the dialing list, RIPterm will abort all dialing and
  2123.     return to the RIPterm session window.
  2124.  
  2125. ┌────────────────────────────────────────────────────────────────────┐
  2126. │                       2.5 ■ SCROLLBACK MODE                        │
  2127. └────────────────────────────────────────────────────────────────────┘
  2128.  
  2129. Scrollback mode allows you to review previously displayed text
  2130. information that has come across the modem.  You may set the
  2131. scrollback buffer size to 5k - 64k.
  2132.  
  2133. Within scrollback, you may choose from the following options:
  2134.  
  2135.     ■ SAVE buffer page to a text file
  2136.     ■ SAVE entire buffer to a text file
  2137.     ■ PRINT the current buffer page, or the entire buffer
  2138.     ■ SEARCH for a particular piece of text
  2139.     ■ SEARCH again for a previously searched for text string
  2140.  
  2141. At the top of the scrollback screen are a number of icons for the
  2142. above commands.  In addition, there are icons for scrolling up, down,
  2143. paging up and down or moving to the beginning or end of the buffer.
  2144.  
  2145. NOTE: The scrollback buffer filters out ANSI color codes and
  2146.       RIPscrip graphics for an uncluttered text display.
  2147.  
  2148. ┌─────────────────────────────┐
  2149. │ EDITING THE SCROLLBACK SIZE │
  2150. └─────────────────────────────┘
  2151.  
  2152. This option allows you to specify how much RAM RIPterm should use for
  2153. the scrollback buffer.  You may choose from 5k - 64k of RAM.
  2154. Depending on how much conventional memory you have on your computer,
  2155. this may limit the amount of memory you can allocate to scrollback.
  2156. We recommend that you set it to somewhere around 32k unless you know
  2157. that your PC has quite a bit of its 640k memory free for use.  If you
  2158. have many memory resident programs (TSR's) loaded, you may need to
  2159. drop the size of your scrollback buffer to a smaller value for proper
  2160. operation of RIPterm.
  2161.  
  2162. If RIPterm runs out of memory, it will begin to discard old
  2163. scrollback information until it can satisfy the memory request.
  2164.  
  2165. ┌────────────────────────────────────────────────────────────────────┐
  2166. │                        2.6 ■ THE STATUS BAR                        │
  2167. └────────────────────────────────────────────────────────────────────┘
  2168.  
  2169. At the bottom of the screen is the status bar (normally on).  This
  2170. gives you information about the current configuration of RIPterm.  It
  2171. also provides you with a quick and easy way to access several of the
  2172. basic features of RIPterm without having to use the menus.
  2173.  
  2174. You may toggle the status bar ON and OFF quickly by pressing
  2175. ALT-SPACE.  The host might turn the status bar ON or OFF for you,
  2176. using RIPscrip commands.  If it mysteriously vanishes for some
  2177. reason, keep in mind that the host you are connected to probably did
  2178. it because it needs the extra line for text!
  2179.  
  2180. There are a number of different "fields" in the Status Bar.  They are:
  2181.  
  2182.         ┌───────────┬─────────────┬──────────┬─────────────────┬
  2183.         │ F1 = Help │ F10 = Menus │ RIPscrip │ 38400 ■ N81 FDX │
  2184.         └───────────┴─────────────┴──────────┴─────────────────┴
  2185.              (1)          (2)          (3)      (4)      (5)
  2186.  
  2187.         ┬──────┬──────────────────┬─────────┐
  2188.         │ COM1 │ RIPterm v1.50.00 │ Offline │
  2189.         ┴──────┴──────────────────┴─────────┘
  2190.           (6)           (7)           (8)
  2191.  
  2192.         (1) How to get the help system table of contents
  2193.  
  2194.         (2) How to use the keyboard only to select from the menus
  2195.  
  2196.         (3) What terminal emulation is in use, or the name of the log
  2197.             file if one has been opened
  2198.  
  2199.         (4) The baud rate, parity setting, data bits and stop bits
  2200.  
  2201.         (5) Full-duplex (FDX) or half-duplex (HDX)settings
  2202.  
  2203.         (6) The COM port that is currently in use
  2204.  
  2205.         (7) The current version number of RIPterm
  2206.  
  2207.         (8) Whether you are "on-line" or "off-line"
  2208.  
  2209. Each one of the fields just described can be clicked on (if the
  2210. status bar is on).  Once clicked, a different action is performed
  2211. based upon the current state of RIPterm, and what field you clicked
  2212. on.  Each of the various fields are described below:
  2213.  
  2214.     ┌────────────────────────┐
  2215.     │ HELP TABLE OF CONTENTS │
  2216.     └────────────────────────┘
  2217.  
  2218.     This option displays the Help Table of Contents.  From here, you
  2219.     can access any area in the Help System quickly and easily.
  2220.  
  2221.     ┌─────────────────────┐
  2222.     │ ACCESSING THE MENUS │
  2223.     └─────────────────────┘
  2224.  
  2225.     When you click on this option, the menu bar at the top of the
  2226.     screen will be highlighted for you.  You may then use the
  2227.     keyboard to navigate through the menus quickly and easily to
  2228.     choose options.
  2229.  
  2230.     ┌─────────────┐
  2231.     │ MISC. FIELD │
  2232.     └─────────────┘
  2233.  
  2234.     This field serves two purposes.  If you are current logging your
  2235.     session to a disk "log file", the filename (without extension) of
  2236.     the log file will be displayed in here.  In this mode, clicking
  2237.     in this field will close (or pause) the log file.  If you are not
  2238.     logging your session to disk, then this field will display the
  2239.     phrase "RIPscrip", indicating that you are using a RIPscrip
  2240.     compatible terminal program.  Clicking on this field in this mode
  2241.     will bring up a help screen telling you more about RIPscrip
  2242.     graphics in general.
  2243.  
  2244.     ┌─────────────────────────┐
  2245.     │ COMMUNICATIONS SETTINGS │
  2246.     └─────────────────────────┘
  2247.  
  2248.     This field indicates what the current communications parameters
  2249.     are.  The baud rate (300-115,200 baud) is displayed as well as
  2250.     the data bits (7 or 8), parity ( N = none, E = even and O = odd),
  2251.     and stop bits (1 or 2).  If local-echo is enabled, then the
  2252.     phrase "HDX" is displayed which means "Half Duplex".  If this is
  2253.     disabled (no echo), then the phrase "FDX" is displayed indicating
  2254.     "Full Duplex" mode is in effect.
  2255.  
  2256.     Clicking on this field brings up the Modem Settings dialog box.
  2257.  
  2258.     ┌─────────────────────┐
  2259.     │ COMMUNICATIONS PORT │
  2260.     └─────────────────────┘
  2261.  
  2262.     This field displays what communications port you are using.
  2263.     Clicking on this field brings up the modem settings dialog box.
  2264.  
  2265.     ┌─────────────────────┐
  2266.     │ RIPTERM INFORMATION │
  2267.     └─────────────────────┘
  2268.  
  2269.     This field displays the version number of RIPterm that you are
  2270.     using.  Clicking on it brings up a help screen corresponding to
  2271.     "About RIPterm" in the Project menu.  It displays information
  2272.     about the current version of RIPterm.
  2273.  
  2274.     ┌────────────────────────────┐
  2275.     │ ON-LINE/OFF-LINE INDICATOR │
  2276.     └────────────────────────────┘
  2277.  
  2278.     This field displays whether you are on-line or off-line. When
  2279.     RIPterm is starting up, you might see the phrase "Loading..." in
  2280.     this field; this is just a status indicator telling you RIPterm
  2281.     is doing something.  The purpose of this field is for you to be
  2282.     able to, at a glance, determine if you are still connected to a
  2283.     host or not.  This field is updated whenever your on-line status
  2284.     changes in any way (providing your modem is configured for
  2285.     carrier detect!).
  2286.  
  2287.     Clicking on this field will do one of two things depending on
  2288.     what the current on-line/off-line status is.  if you are on-line,
  2289.     clicking on this field will ask you if you wish to hang-up
  2290.     (providing you are using your modem to connect to a host).  If it
  2291.     says you are off-line, clicking on this field will bring up the
  2292.     dialing directory, thus allowing you to dial a host.
  2293.  
  2294. ┌────────────────────────────────────────────────────────────────────┐
  2295. │                       2.7 ■ STARTING RIPTERM                       │
  2296. └────────────────────────────────────────────────────────────────────┘
  2297.  
  2298. There are a number of options that you may choose from when starting
  2299. up RIPterm.  These options are specified as "parameters" on the DOS
  2300. command line.  Each option is preceded with either a hyphen (-) or a
  2301. forward slash (/).  Each option is described below:
  2302.  
  2303.     -N         ... Suppress the intro screen
  2304.     -M         ... Disables all mouse activity
  2305.     -O         ... Indicate you are already on-line (don't init modem)
  2306.     -E         ... Disable extended keyboard support
  2307.     -Z         ... Disable zooming windows
  2308.     -D<entry#> ... Dial <entry#> upon start up (from 1-100)
  2309.     -P<file>   ... Use an alternate phone directory file
  2310.     -R<file>   ... Play-back .RIP file upon start up
  2311.     -S<file>   ... Use an alternate setup file
  2312.  
  2313. Command line options are not case sensitive.  You may specify these
  2314. options together (for single character options), or as separate
  2315. parameters on the command line.  For example, to suppress the intro
  2316. screen, disable zooming windows and indicate that you are already
  2317. on-line, you could execute the following DOS command:
  2318.  
  2319.     RIPTERM -noz
  2320.  
  2321. Each of these options are described more fully in the following
  2322. sub-sections:
  2323.  
  2324.     ┌──────────────────────────────────┐
  2325.     │ -N ... Suppress the Intro Screen │
  2326.     └──────────────────────────────────┘
  2327.  
  2328.     When you choose this option, the start up logo screen is
  2329.     disabled.  You will be placed directly into RIPterm's session
  2330.     screen providing there are no configuration problems, or other
  2331.     questions that RIPterm must ask you in order to run properly.
  2332.  
  2333.     ┌────────────────────────────────────┐
  2334.     │ -M ... Disables all Mouse Activity │
  2335.     └────────────────────────────────────┘
  2336.  
  2337.     When you choose this option, RIPterm will not check for a mouse.
  2338.     In fact, regardless of whether or not a mouse is installed,
  2339.     RIPterm will not use it.  Generally speaking, you will probably
  2340.     never need to use this option unless you find that RIPterm
  2341.     doesn't operate properly with your mouse.
  2342.  
  2343.     ┌────────────────────────────────────────────────────────────┐
  2344.     │ -O ... Indicate you are already on-line (don't init modem) │
  2345.     └────────────────────────────────────────────────────────────┘
  2346.  
  2347.     When you choose this option, RIPterm will not initialize the
  2348.     modem for you (if your default mode is "modem connection" mode).
  2349.     If you are in this state, RIPterm will simply start up and press
  2350.     the <ENTER> key.  This is done to (ideally) display some kind of
  2351.     prompt on the host for you (or at least something). Note that
  2352.     RIPterm will auto-sense if you are already on-line and do this for
  2353.     you if it detects you're on-line.  This only applies to modem
  2354.     connection mode.
  2355.  
  2356.     If you are in non-modem connection mode and you specify this
  2357.     option, RIPterm will start up and do absolutely nothing.  It will
  2358.     not press the <ENTER> key for you.  It will simply enter the
  2359.     session screen and sit there waiting for you to do something.
  2360.  
  2361.     ┌──────────────────────────────────────────┐
  2362.     │ -E ... Disable extended keyboard support │
  2363.     └──────────────────────────────────────────┘
  2364.  
  2365.     This option is primarily for use when you are trying to
  2366.     troubleshoot the "doorway mode".  Doorway mode will take
  2367.     advantage of a 101-key enhanced AT computer keyboard.  If you
  2368.     enable 101-key keyboard mode, and you do not have a 101-key
  2369.     keyboard (or RIPterm doesn't think you have one), RIPterm might
  2370.     lock-up.  If you inadvertently saved this setup, the next time
  2371.     RIPterm starts up, it could freeze up on you when you enter
  2372.     doorway mode again.  In this case, use this start up option to
  2373.     "override" 101-key keyboard mode so that you can disable it and
  2374.     fix things for normal operation. This option should almost never
  2375.     be necessary except in troubleshooting situations.
  2376.  
  2377.     ┌────────────────────────────────┐
  2378.     │ -Z ... Disable Zooming Windows │
  2379.     └────────────────────────────────┘
  2380.  
  2381.     This option will disable the zooming windows feature of RIPterm
  2382.     for the duration of the current RIPterm session.  This mode
  2383.     overrides the setup option for zooming windows.  If you select
  2384.     Save Setup from the Modem menu, this override will become
  2385.     permanent (until changed and saved).  Some people find the
  2386.     zooming windows feature annoying in that it slows down operation
  2387.     of opening and closing windows a little bit.  For these power
  2388.     users, you may use this option, or simply save the zoom windows
  2389.     off setting to your setup.
  2390.  
  2391.     ┌─────────────────────────────────────────────────────────┐
  2392.     │ -D<entry#> ... Dial <entry#> upon start up (from 1-100) │
  2393.     └─────────────────────────────────────────────────────────┘
  2394.  
  2395.     This option will instruct RIPterm to automatically dial a
  2396.     particular entry in the dialing directory immediately after it
  2397.     initializes the Modem (if necessary).  Whether or not the
  2398.     connection can be established or not is unimportant, RIPterm will
  2399.     remain active regardless.  Use this option from within a batch
  2400.     file if you frequently start up RIPterm and need to dial a
  2401.     particular number. You may specify a dialing directory entry from
  2402.     1-100.  An example of using this option is as follows:
  2403.  
  2404.         RIPTERM -D15
  2405.  
  2406.     The above example starts up RIPterm, places a call to dialing
  2407.     directory entry #15 just as if you had selected it manually.
  2408.  
  2409.     ┌────────────────────────────────────────────────────┐
  2410.     │ -P<file> ... Use an alternate Phone Directory file │
  2411.     └────────────────────────────────────────────────────┘
  2412.  
  2413.     This option instructs RIPterm to load a dialing directory file
  2414.     other than RIPTERM.PHO upon start up.  This option is useful if
  2415.     you frequently use a special dialing directory file for certain
  2416.     applications.  This option can be used with the command line
  2417.     option to automatically dial a directory entry upon start up.  In
  2418.     other words, you can combine the -P and -D parameters together on
  2419.     the same command as in the following example:
  2420.  
  2421.                         RIPTERM -Pmyfile.pho -D3
  2422.  
  2423.     The above example would load RIPterm, load the directory file
  2424.     called MYFILE.PHO, initialize the modem, then automatically dial
  2425.     entry number 3 in the MYFILE.PHO dialing directory file.
  2426.  
  2427.     ┌────────────────────────────────────────────────┐
  2428.     │ -R<file> ... Play-back .RIP file upon start up │
  2429.     └────────────────────────────────────────────────┘
  2430.  
  2431.     This option allows you to execute a local .RIP file upon initial
  2432.     start up of RIPterm.  This allows you to draw some graphics, or
  2433.     even set up a screen with modem configuration mouse buttons.
  2434.     This allows for a great deal of flexibility.
  2435.  
  2436.     ┌──────────────────────────────────────────┐
  2437.     │ -S<file> ... Use an alternate setup file │
  2438.     └──────────────────────────────────────────┘
  2439.  
  2440.     This option allows you to specify an alternate RIPterm setup file
  2441.     upon start up.  By default, RIPterm will load RIPTERM.CNF (or
  2442.     create one if necessary).  Use this option if you frequently
  2443.     start up in a particular configuration (e.g., using a COM port
  2444.     other than the standard default port that is recorded in
  2445.     RIPTERM.CNF). This option may be combined with any other command
  2446.     line parameter for RIPterm as in the following example:
  2447.  
  2448.         RIPTERM -nz -Pmyfile.pho -Smysetup.cnf -D10
  2449.  
  2450.     The above example suppresses the intro logo screen, instructs
  2451.     RIPterm not to use zooming windows, loads the dialing directory
  2452.     file MYFILE.PHO, loads configuration file MYSETUP.CNF and
  2453.     automatically dials directory entry #10 upon start up.  This is
  2454.     about as complex of a start up example as you can get.  This is
  2455.     typically nothing like what you would ever use with RIPterm
  2456.     unless you are what is commonly referred to as a "Power User",
  2457.     whereby this stuff would be old hat to you anyway.
  2458.  
  2459. ┌────────────────────────────────────────────────────────────────────┐
  2460. │                         2.8 ■ MACRO EDITOR                         │
  2461. └────────────────────────────────────────────────────────────────────┘
  2462.  
  2463. Macros are functions that you can define to perform short-cut
  2464. operations on the host.  For example, you can instruct RIPterm to
  2465. make the F5 key type your user-id and press <ENTER> for you.  This
  2466. would allow you to log-on quickly by simply pressing a single key.
  2467. RIPterm's macro system is easy to use, and very powerful!  You can
  2468. save your macro keys to the default macro file (RIPTERM.KEY), or if
  2469. you need to have multiple macro configurations, you can save macros
  2470. to different files.
  2471.  
  2472. When you choose the macro editor option, a dialog box similar to the
  2473. following will be displayed:
  2474.  
  2475.    ╔══════════════════════════════════════════════════════════════╗
  2476.    ║                     RIPterm Macro Editor                     ║
  2477.    ║  ┌──────────────────────────────────────┬─┐  ┌────────────┐  ║
  2478.    ║  │  CTRL-F2: This is Macro #1 ......... ││  │    EDIT    │  ║
  2479.    ║  ├──────────────────────────────────────┼─┤  ├────────────┤  ║
  2480.    ║  │    ALT-G: This is Macro #2 ......... │ │  │   DELETE   │  ║
  2481.    ║  ├──────────────────────────────────────┤ │  ├────────────┤  ║
  2482.    ║  │       F2: This is Macro #3 ......... │ │  │    CLEAR   │  ║
  2483.    ║  ├──────────────────────────────────────┤ │  ├────────────┤  ║
  2484.    ║  │ SHIFT-F9: This is Macro #4 ......... │ │  │    SAVE    │  ║
  2485.    ║  ├──────────────────────────────────────┼─┤  ├────────────┤  ║
  2486.    ║  │ CTRL-F10: This is Macro #5 ......... ││  │    LOAD    │  ║
  2487.    ║  └──────────────────────────────────────┴─┘  └────────────┘  ║
  2488.    ║          ┌──────────────┐          ┌──────────────┐          ║
  2489.    ║          │      OK      │          │    CANCEL    │          ║
  2490.    ║          └──────────────┘          └──────────────┘          ║
  2491.    ╚══════════════════════════════════════════════════════════════╝
  2492.  
  2493. The currently defined macros are displayed in the scrolling window on
  2494. the left side of the dialog box.  On the right side, are buttons
  2495. which allow you to add/edit macros, delete existing macros, Clear all
  2496. macros, load a macro file and save all macros to a macro file.
  2497.  
  2498. When selecting macros to edit/delete, you may click on an existing
  2499. macro then click on EDIT or DELETE.  If you wish to edit/delete more
  2500. than one macro at the same time, click on each macro while holding
  2501. down the SHIFT key.  If you click on EDIT without any macros being
  2502. highlighted, you go into ADD macro mode.
  2503.  
  2504. You may store multiple macros into Macro .KEY Files for future use.
  2505. You may have as many macro files as you wish limited only by the
  2506. amount of available disk space.
  2507.  
  2508. ┌──────────────────────────────────────┐
  2509. │ ENTER KEYSTROKE FOR THE MACRO EDITOR │
  2510. └──────────────────────────────────────┘
  2511.  
  2512. Type the keystroke that you wish to record a macro for.  For example,
  2513. if you wanted to record a macro for the F5 key, simply press the F5
  2514. key.  You may specify CTRL, ALT or SHIFT keys as well.  RIPterm's
  2515. macro editor allows you to define literally hundreds of macros using
  2516. nearly as complex a keystroke as you want.  To exit the ADD mode,
  2517. simply press the <SPACE> key.  Beware that you probably would never
  2518. want to make CTRL-M (return), CTRL-H (backspace) or ALT-K (keystroke
  2519. macros) into macros themselves.  This would make it difficult to use
  2520. RIPterm with the keyboard.
  2521.  
  2522. ┌────────────────────────────────────────────┐
  2523. │ TEXT TO SEND HOST WHEN THIS KEY IS PRESSED │
  2524. └────────────────────────────────────────────┘
  2525.  
  2526. Enter the text that should be sent to the host (or the modem) if this
  2527. macro is entered.  In other words, enter the text that you want to be
  2528. associated with this macro.  For example, if you wanted to send the
  2529. text "Hello World" to the host when you press F5, simply type in
  2530. "Hello World".
  2531.  
  2532. You may enter control characters into your macros by using a caret
  2533. (^), followed by the letter of the control key you want to send.  For
  2534. example, a CTRL-C would be represented as ^C.  A carriage return
  2535. (<ENTER>) is specified as ^M.  Also, an ESCAPE is generated by the
  2536. sequence ^[ ... There are a number of different combinations of
  2537. CONTROL CHARACTERS that you may choose from (see SECTION 2.8.1 for
  2538. more details).
  2539.  
  2540. In addition to control characters, you can also insert TEXT VARIABLES
  2541. (SECTION 2.8.2) or POPUP LISTS (SECTION 2.8.3) into your macros.  See
  2542. the following sections of the manual for further information.
  2543.  
  2544. ┌──────────────────────────────┐
  2545. │ SAVING YOUR MACROS TO A FILE │
  2546. └──────────────────────────────┘
  2547.  
  2548. Enter the filename that you want to save your defined macros to.  By
  2549. default, the Macro File RIPTERM.KEY is prompted.  If you do not wish
  2550. to store your existing macros as the "Default RIPterm" macros, save
  2551. them to a different file.
  2552.  
  2553. ┌─────────────────────────────────┐
  2554. │ LOADING YOUR MACROS FROM A FILE │
  2555. └─────────────────────────────────┘
  2556.  
  2557. Enter the filename of the macro .KEY file you wish to load.  Macro
  2558. files are contained in the current RIPTERM directory unless otherwise
  2559. specified.  By default, RIPTERM.KEY is prompted, so that you can load
  2560. the default macros quickly and easily.  If you wish to load a custom,
  2561. non-default macro file, simply backspace over the existing filename
  2562. and enter the filename you wish to load.
  2563.  
  2564. ┌────────────────────────────────────────────────────────────────────┐
  2565. │                     2.8.1 ■ CONTROL CHARACTERS                     │
  2566. └────────────────────────────────────────────────────────────────────┘
  2567.  
  2568. Not all hosts will allow you to use control characters.  Regardless
  2569. of that, the capability to send any control character exists in your
  2570. keystroke macro editor.  The most commonly used control characters
  2571. are:
  2572.  
  2573.     INDIVIDUAL CONTROL CHARACTERS           SPECIAL KEYSTROKES
  2574.     ----------------------------------      ----------------------
  2575.     ^G ... Beep                             ^[[A ... Up arrow
  2576.     ^L ... Clear screen (top of form)       ^[[B ... Down arrow
  2577.     ^M ... Carriage return                  ^[[C ... Right arrow
  2578.     ^C ... Break (on some hosts)            ^[[D ... Left arrow
  2579.     ^H ... Backspace                        ^[[H ... Home key
  2580.     ^[ ... Escape character (ESC)           ^[[K ... End key
  2581.     ^S ... Pause data transmission (X-OFF)  ^[[L ... Control home
  2582.     ^Q ... Resume data transmission (X-ON)
  2583.  
  2584. ┌────────────────────────────────────────────────────────────────────┐
  2585. │                       2.8.2 ■ TEXT VARIABLES                       │
  2586. └────────────────────────────────────────────────────────────────────┘
  2587.  
  2588. A special feature of RIPterm allows it to understand what a text
  2589. variable is.  A text variable is a string of text that RIPterm knows
  2590. represents something more.  For example, the text variable $DATE$ is
  2591. known to represent the current date on your system.  The host may ask
  2592. your system what the values of one or more of these variables are,
  2593. and if your terminal knows that particular text variable, it will
  2594. send that information to the host.
  2595.  
  2596. There are two types of text variables.  There are built-in text
  2597. variables that RIPterm will ALWAYS know about.  Then there are also
  2598. user text variables that can contain a variety of information
  2599. depending on what the RIPterm user entered at the time the variable
  2600. was created.  For example, the host might ask you what the contents
  2601. of the $FULL_NAME$ variable is, and if RIPterm doesn't know, it would
  2602. pop-up a field on the screen and ask you about it.  From then on,
  2603. RIPterm will remember that piece of information for the next time it
  2604. is needed by a host.
  2605.  
  2606. You may use either the pre-defined text variables, or the user text
  2607. variables at any place that allows text variables (i.e., keystroke
  2608. macros).
  2609.  
  2610. ┌────────────────────────────────────────────────────────────────────┐
  2611. │                   2.8.2.1 ■ USER TEXT VARIABLES                    │
  2612. └────────────────────────────────────────────────────────────────────┘
  2613.  
  2614. User text variables are text variables that you create.  A host might
  2615. tell you, "Create this text variable for me", or you might create one
  2616. yourself.  The difference is really unimportant.  However, a brief
  2617. explanation of their purpose might prove insightful.
  2618.  
  2619. User text variables are used to store information either permanently,
  2620. or temporarily.  This information can then be re-used without you
  2621. having to type them in again.  The time-saving aspect of this feature
  2622. is only one small benefit of its ability.  Having the capability to
  2623. store information over potentially long periods of time is VERY
  2624. useful!
  2625.  
  2626. There are three types of user text variables:
  2627.  
  2628. 1. Permanent (database)    variables
  2629. 2. Temporary (in memory)   variables
  2630. 3. Volatile  (discardable) variables
  2631.  
  2632. The significance of each type of variable is described below:
  2633.  
  2634. ┌────────────────────────────────┐
  2635. │ PERMANENT (DATABASE) VARIABLES │
  2636. └────────────────────────────────┘
  2637.  
  2638. Permanent text variables are saved in a local RIPterm database file
  2639. called RIPTERM.DB.  This file is automatically indexed for high-speed
  2640. retrieval of information.  The index file for this database is called
  2641. RIPTERM.IDX.  Both files are stored in the current RIPterm directory
  2642. for safe keeping.  Any permanent text variable that is created is
  2643. stored in this file.
  2644.  
  2645. A permanent text variable can be created by yourself manually by
  2646. choosing option "Store Data" from the Data menu, or interactively by
  2647. a host via a special RIPscrip command ("Define Text Variable").  Once
  2648. you create a variables, they are stored forever, or until you either
  2649. delete the database file, or modify the entry.  These variables may
  2650. be accessed by yourself, or a host (if you wish it).  This can be
  2651. quite useful in preventing you from having to type the same
  2652. information in over and over again in future on-line sessions. Imagine
  2653. if you could sign-up on a host without having to type a single
  2654. character?  Sound too good to be true?  With text variables, you (and
  2655. other sysops) could do this!
  2656.  
  2657. ┌─────────────────────────────────┐
  2658. │ TEMPORARY (IN MEMORY) VARIABLES │
  2659. └─────────────────────────────────┘
  2660.  
  2661. Temporary (in memory) text variables are just like permanent text
  2662. variables, except that they are not stored in a database file.  They
  2663. are stored in your computer's memory.  They remain until you exit
  2664. RIPterm.  Other than that, they are identical in nature to permanent
  2665. text variables.  Until you exit RIPterm, they will exist and will be
  2666. accessible to you (via macros), or to a host.
  2667.  
  2668. ┌──────────────────────────────────┐
  2669. │ VOLATILE (DISCARDABLE) VARIABLES │
  2670. └──────────────────────────────────┘
  2671.  
  2672. A volatile (discardable) text variable is somewhat different than the
  2673. previously described text variables.  They do not remain in memory or
  2674. in any database for any period of time.  They are used solely to ask
  2675. you a simple question, transmit the information to the host, then the
  2676. contents of the variable are destroyed forever.  Why would you (or a
  2677. host) want something like this?  This question is answered
  2678. differently for YOU or for a host.
  2679.  
  2680. A volatile text variable for you can be useful during keystroke
  2681. macros.  Let's say you have a very complex macro that you've devised
  2682. for doing something in a game (for example) to another user on the
  2683. host.  Should you have to edit the macro each time you want to
  2684. use it for someone different?  Of course not!  Simply place a
  2685. reference to an "undefined" text variable in your macro.  When you
  2686. execute the macro, RIPterm will look through its list of text
  2687. variables (pre-defined, in-memory and permanent), and if it doesn't
  2688. find a corresponding variable, it would pop-up a quick dialog box
  2689. asking you to enter something for that variable.  Whatever you type
  2690. into that dialog box for the variable is replaced in your macro right
  2691. then and there, and is immediately discarded after the macro is
  2692. finished.  For example, let's say you have the following macro setup
  2693. to attack another player in a game on some host you call:
  2694.  
  2695.     F2:  ATTACK $USERNAME$ FIERCELY^m
  2696.  
  2697. When you execute macro F2, RIPterm will transmit "ATTACK " to the
  2698. host, then find the text variable $USERNAME$ in it.  It will check
  2699. its internal tables for this variable, and if it doesn't find it, it
  2700. will pop-up a window asking you to enter the following:
  2701.  
  2702.       ╔════════════════════════════════════════════════════════╗
  2703.       ║                Please enter "USERNAME"                 ║
  2704.       ║  ┌──────────────────────────────────────────────────┐  ║
  2705.       ║  │ █                                                │  ║
  2706.       ║  └──────────────────────────────────────────────────┘  ║
  2707.       ╚════════════════════════════════════════════════════════╝
  2708.  
  2709. Simply type in the name of the user you wish to attack, and the
  2710. result will be sent to the host in place of the variable name
  2711. $USERNAME$.  After that, the remainder of the macro will be
  2712. transmitted to the host (i.e., " FIERCELY") followed by a carriage
  2713. return (^M is the carriage return).  Once the macro is complete, the
  2714. contents of USERNAME will not exist (unless it was a previously
  2715. defined "permanent" text variable or a Temporary (in memory) text
  2716. variable.
  2717.  
  2718. A host can also ask you to enter something for a volatile text
  2719. variable.  Why would a host want to do this and not save the response
  2720. somewhere?  What if you asked a host to download a file.  It could
  2721. present you with a menu like the following:
  2722.  
  2723.             ╔═══════════════════════════════════════════╗
  2724.             ║                File Download              ║
  2725.             ║  ┌─────────────┐  ┌────────────────────┐  ║
  2726.             ║  │  Protocols  │  │   Enter Filename   │  ║
  2727.             ║  ├─────────┬───┤  └────────────────────┘  ║
  2728.             ║  │ X-Modem │   │  ╔════════════════════╗  ║
  2729.             ║  │ Y-Modem │   │  ║   Begin Download   ║  ║
  2730.             ║  │ Z-Modem │ X │  ╚════════════════════╝  ║
  2731.             ║  │ Kermit  │   │  ┌────────────────────┐  ║
  2732.             ║  └─────────┴───┘  │  Cancel Download!  │  ║
  2733.             ║                   └────────────────────┘  ║
  2734.             ╚═══════════════════════════════════════════╝
  2735.  
  2736. The options on the left allow you to specify the file transfer
  2737. protocol that you wish to use for the transfer.  The "Enter Filename"
  2738. button though is the one we're interested in.  When you click on this
  2739. button, you would think that RIPterm should pop-up a dialog box on
  2740. your screen asking you what filename you want to download, right?
  2741. Would you think that the filename you enter should become a permanent
  2742. part of RIPterm's configuration?  Of course not.  It saved only
  2743. temporarily until such time as you click on either "Begin Download"
  2744. or "Cancel Download!".  Its value is used specifically when you click
  2745. on "Begin Download" whereby RIPterm looks at all of the buttons on
  2746. the screen and instructs the host to begin the download in a certain
  2747. way (e.g., using Z-Modem protocol to download file XYZ.EXE for
  2748. example).  As you can clearly see, you would not want the filename
  2749. field to be part of your permanent RIPterm configuration.  In this
  2750. manner, volatile text variables can be extremely useful!
  2751.  
  2752. ┌────────────────────────────────────────────────────────────────────┐
  2753. │               2.8.2.2 ■ USER TEXT VARIABLE SECURITY                │
  2754. └────────────────────────────────────────────────────────────────────┘
  2755.  
  2756. All this discussion about user text variables, and hosts asking your
  2757. terminal for information, you might be concerned about calling some
  2758. host you've never called before and letting it ask your terminal
  2759. questions about itself (and YOU)!  We don't blame you for thinking
  2760. this.  That is why we've put a security precaution into RIPterm.  It
  2761. is called "Data Security".  This option (available from the Data
  2762. menu) allows you to preview any user text variable question to
  2763. determine if you really and truly want to send that information to
  2764. the host.  This allows you to edit the text variable that will be
  2765. sent to the host so that you are in control at all times of what
  2766. information is sent to the host.  Any variable that is queried by the
  2767. host will be prompted on your screen allowing you to edit the
  2768. response.  In the event that you do not wish to divulge the
  2769. information to the host, simply backspace over your text and send a
  2770. "blank" response.  In the event that the host won't permit a blank
  2771. response, enter something like "NONE" or "N/A".
  2772.  
  2773. If this mode is disabled, you may still be prompted to edit your
  2774. variable if the host asks for an "interactive query".  The host can
  2775. ask for a non-interactive text variable query, which means that the
  2776. host will "try" to ask your terminal the contents of a text variable.
  2777. If the variable exists, it will send the contents to the host without
  2778. you even knowing that it was sent!  In some ways, it is up to the
  2779. honor of the sysop of the host to set all variable queries as
  2780. interactive by default.  But considering the fact that this is not an
  2781. entirely "equal" world, having the ability to override variable
  2782. queries with a Data Security option becomes quite important.
  2783.  
  2784. This option defaults to "ON" when RIPterm is initially installed.  In
  2785. other words, all data queries are considered "secure" by default.  It
  2786. is up to you to disable this security measure.  Use this option with
  2787. caution if you're not sure about trusting the hosts you call.
  2788.  
  2789. As a note worth mentioning, a RIPscrip command to query the contents
  2790. of your terminal's text variables may be possible if you read an
  2791. electronic mail message from an ingenious user who knows the RIPscrip
  2792. protocol language.  In situations like this, you would definitely
  2793. want to use data security mode to prevent unauthorized information
  2794. transmittal to other people (e.g., credit card numbers, or other
  2795. information).
  2796.  
  2797. ┌────────────────────────────────────────────────────────────────────┐
  2798. │                2.8.2.3 ■ PRE-DEFINED TEXT VARIABLES                │
  2799. └────────────────────────────────────────────────────────────────────┘
  2800.  
  2801. Pre-defined text variables are something that RIPterm always knows
  2802. about.  They are "built-in" to RIPterm, and a host can always get an
  2803. answer to.  These types of variables are defined to provide the host
  2804. with some kind of information about your terminal software, not about
  2805. something you (or your terminal) knows.  In other words, pre-defined
  2806. text variables can be used to send a piece of information to the host
  2807. saying "what time is it", or "what is the date where you are", or
  2808. "where is the mouse located?".  They function exactly like any other
  2809. text variable except that RIPterm knows they exist even if you
  2810. haven't created them yet. By nature, the values that these variables
  2811. return to the host are rarely the same.  They change depending on the
  2812. nature of each variable.
  2813.  
  2814. The following is a list of pre-defined text variables:
  2815.  
  2816.  
  2817.     $DATE$ ... Date in short format (e.g., 12/19/92)
  2818.  
  2819.     This Text Variable will be transformed into the current Date.
  2820.     It will be displayed in the format MM/DD/YY.
  2821.  
  2822.         Example:  $DATE$ = 12/19/92
  2823.  
  2824.     -----------------------------------------------------------------
  2825.  
  2826.     $MONTH$ ... Month Name
  2827.  
  2828.     This text variable will be transformed into the name of the
  2829.     current month.  It will be not abbreviated (e.g., "November"
  2830.     instead of "Nov")
  2831.  
  2832.         Example:  $MONTH$ = December
  2833.  
  2834.     -----------------------------------------------------------------
  2835.  
  2836.     $MONTHNUM$ ... Month (in format 1-12)
  2837.  
  2838.     This text variable is transformed into a number representing
  2839.     the current month.  January=01 and December=12.  Therefore,
  2840.     the possible values for $MONTHNUM$ can range from 1 to 12.
  2841.  
  2842.         Example:  $MONTHNUM$ = 12
  2843.  
  2844.     -----------------------------------------------------------------
  2845.  
  2846.     $DAY$ ... Day in numeric form (e.g., 31)
  2847.  
  2848.     This text variable is transformed into a number representing the
  2849.     day of the month.  The range of values for this variable are from
  2850.     01-31.
  2851.  
  2852.         Example:  $DAY$ = 05
  2853.  
  2854.     -----------------------------------------------------------------
  2855.  
  2856.     $DOY$ ... Day of year (001-366)
  2857.  
  2858.     This text variable will be transformed into a number representing
  2859.     the day of the current year.  Since a year contains 365 days
  2860.     (unless it is a leap-year where it contains 366), then the
  2861.     possible values that $DOY$ can be are 001-366.
  2862.  
  2863.         Example: $DOY$ = 214
  2864.  
  2865.     -----------------------------------------------------------------
  2866.  
  2867.     $YEAR$ ... 2 digit year (without century) (00-99)
  2868.  
  2869.     This text variable will be transformed into a two-digit number
  2870.     representing the current year.
  2871.  
  2872.         Example: $YEAR$ = 92
  2873.  
  2874.     -----------------------------------------------------------------
  2875.  
  2876.     $FYEAR$ ... 4 digit year (with century) (0000-9999)
  2877.  
  2878.     This text variable will be transformed into a four-digit number
  2879.     that represents the current year.
  2880.  
  2881.         Example:  $FYEAR$ = 1992
  2882.  
  2883.     -----------------------------------------------------------------
  2884.  
  2885.     $TIME$ ... Time in standard format (e.g., 12:03:14)
  2886.  
  2887.     This text variable will be transformed into the current time.
  2888.     The time will be in military format (hours from 00-23).
  2889.  
  2890.         Example:  $TIME$ = 18:09:33
  2891.  
  2892.     -----------------------------------------------------------------
  2893.  
  2894.     $HOUR$ .... Hour (format HH) - normal style
  2895.  
  2896.     This text variable will be transformed into a two-digit number
  2897.     representing the current hour.  This variable may be anywhere
  2898.     from 01-12.  This does not use military format.
  2899.  
  2900.         Example:  $HOUR$ = 11
  2901.  
  2902.     -----------------------------------------------------------------
  2903.  
  2904.     $MHOUR$ ... Hour (format HH) - Military style
  2905.  
  2906.     This text variable will be transformed into a two-digit number
  2907.     representing the current hour in military format.  This variable
  2908.     may range anywhere from 00-23.
  2909.  
  2910.         Example: $MHOUR$ = 17
  2911.  
  2912.     -----------------------------------------------------------------
  2913.  
  2914.     $MIN$ ... Minutes (00-59)
  2915.  
  2916.     This text variable will be transformed into a two-digit number
  2917.     representing the current minutes in the hour.  Possible values
  2918.     for this variable are 00-59.
  2919.  
  2920.         Example:  $MIN$ = 45
  2921.  
  2922.     -----------------------------------------------------------------
  2923.  
  2924.     $SEC$ ... Seconds (00-59)
  2925.  
  2926.     This text variable will be transformed into a two-digit number
  2927.     representing the current seconds of the minute.  Possible values
  2928.     for this variable are 00-59.
  2929.  
  2930.         Example: $SEC$ = 59
  2931.  
  2932.     -----------------------------------------------------------------
  2933.  
  2934.     $AMPM$ ... Returns either AM or PM depending on time
  2935.  
  2936.     This text variable will be transformed into a two-character
  2937.     value of either "AM" or "PM" depending on what time it is.
  2938.  
  2939.         Example: $AMPM$ = PM
  2940.  
  2941.     -----------------------------------------------------------------
  2942.  
  2943.     $DATETIME$ ... Date & Time (e.g., Sat Dec 19 14:38:50 1992)
  2944.  
  2945.     This text variable will be transformed into a combination date
  2946.     and time.  The format is somewhat different than standard
  2947.     time/date notation.  The format used is:
  2948.  
  2949.         DAY-OF-WEEK   MONTH   DAY-OF-MONTH  HH:MM:SS  YEAR
  2950.  
  2951.         Example:  $DATETIME$ = Sat Dec 19 14:38:50 1992
  2952.  
  2953.     -----------------------------------------------------------------
  2954.  
  2955.     $TIMEZONE$ ... Time Zone or "NONE" if unknown (e.g., Pacific)
  2956.  
  2957.     This text variable will be transformed into a a word/phrase that
  2958.     describes the current time-zone you are in.  This may be returned
  2959.     as anything like "PST" for Pacific Standard Time, "EDT" for
  2960.     Eastern Daylight Time, etc.  If the time-zone is not set on your
  2961.     system, this variable will respond with "NONE".
  2962.  
  2963.         Example: $TIMEZONE$ = PST
  2964.  
  2965.     -----------------------------------------------------------------
  2966.  
  2967.     $DOW$ ... Day of week fully spelled out (e.g., Friday)
  2968.  
  2969.     This text variable will be transformed into the current day
  2970.     of the week.  The name will be fully spelled out.  This
  2971.     variable can be any of the values: Sunday, Monday, Tuesday,
  2972.     Wednesday, Thursday, Friday and Saturday.
  2973.  
  2974.         Example:  $DOW$ = Saturday
  2975.  
  2976.     -----------------------------------------------------------------
  2977.  
  2978.     $ADOW$ ... Abbreviated Day of Week (e.g., Mon, Tue, etc.)
  2979.  
  2980.     This text variable will be transformed into the current day
  2981.     of the week, in abbreviated form.  This variable may be any
  2982.     of the following values: Sun, Mon, Tue, Wed, Thu, Fri and Sat.
  2983.  
  2984.         Example:  $ADOW$ = Mon
  2985.  
  2986.     -----------------------------------------------------------------
  2987.  
  2988.     $WDAY$ ... Weekday where 0 is Sunday (0-6)
  2989.  
  2990.     This text variable will be transformed into a one-digit number
  2991.     representing the number of the day of the week.  Possible values
  2992.     for this variable are 0-6, where 0=Sunday (the first day in the
  2993.     week).
  2994.  
  2995.         Example: $WDAY$ = 2
  2996.  
  2997.     -----------------------------------------------------------------
  2998.  
  2999.     $WOY$ ... Week of current year 00-53; Sunday=1st Day of Week
  3000.  
  3001.     This text variable will be transformed into a number from 00-53,
  3002.     representing the week number in the current year.  Even though
  3003.     there are 52 weeks in a year, a week might not begin exactly on
  3004.     the first day of the year, so a maximum value for this variable
  3005.     can be 53 under these circumstances.  For this variable, SUNDAY
  3006.     is considered to be the first day of the week.
  3007.  
  3008.         Example:  $WOY$ = 32
  3009.  
  3010.     -----------------------------------------------------------------
  3011.  
  3012.     $WOYM$ ... Week of current year 00-53; Monday=1st Day of Week
  3013.  
  3014.     This text variable will be transformed into a number from 00-53,
  3015.     representing the week number in the current year.  Even though
  3016.     there are 52 weeks in a year, a week might not begin exactly on
  3017.     the first day of the year, so a maximum value for this variable
  3018.     can be 53 under these circumstances.  For this Variable, MONDAY
  3019.     is considered to be the first day of the week.
  3020.  
  3021.         Example:  $WOYM$ = 32
  3022.  
  3023.     -----------------------------------------------------------------
  3024.  
  3025.     $RIPVER$ ... RIPscrip version (e.g., "RIPSCRIP015000")
  3026.  
  3027.     This text variable will be transformed into a key-phrase which
  3028.     will identify a RIPscrip software package.  It is designed to
  3029.     be used by a host to detect what version of RIPscrip
  3030.     graphics your terminal can support.  When this text variable
  3031.     is used, it will respond back with "RIPSCRIP" followed by
  3032.     the full version number (e.g., 01.50.00), without the periods.
  3033.  
  3034.         Example: $RIPVER$ = RIPSCRIP015000
  3035.  
  3036.     -----------------------------------------------------------------
  3037.  
  3038.     $STATBAR$ ... If Status Bar is on, returns YES, otherwise NO
  3039.  
  3040.     This text variable will be transformed into a "YES" if the status
  3041.     bar is currently ON.  If the Status Bar is not visible, then this
  3042.     variable will be "NO".
  3043.  
  3044.         Example:  $STATBAR$ = YES
  3045.  
  3046.     -----------------------------------------------------------------
  3047.  
  3048.     $X$ ... X Mouse location   (format: XXXX)
  3049.  
  3050.     This text variable is for reporting the current X location of
  3051.     the mouse to the host.  This could be used interactively by the
  3052.     host (or a game on the host) to determine the location of the
  3053.     mouse cursor.  Only the X value of the mouse (X,Y) location is
  3054.     returned to the host.  The value will be 0000-9999 depending on
  3055.     what the current position is.
  3056.  
  3057.         Example:  $X$ = 0523
  3058.  
  3059.     -----------------------------------------------------------------
  3060.  
  3061.     $Y$ ... Y Mouse location   (format: YYYY)
  3062.  
  3063.     This text variable is for reporting the current Y location of
  3064.     the mouse to the host.  This could be used interactively by the
  3065.     host (or a game on the host) to determine the location of the
  3066.     mouse cursor.  Only the Y value of the mouse (X,Y) location is
  3067.     returned to the host.  The value will be 0000-9999 depending on
  3068.     what the current position is.
  3069.  
  3070.         Example:  $Y$ = 0244
  3071.  
  3072.     -----------------------------------------------------------------
  3073.  
  3074.     $XY$ ... X/Y Mouse Location (format: XXXX:YYYY)
  3075.  
  3076.     This text variable will be transformed into a combination of
  3077.     both the X and Y locations of the mouse.  A colon (:) is used to
  3078.     separate the two values.  Either the X or Y values may range from
  3079.     0000-9999 depending on the current location.  The format that
  3080.     this value takes on is:  XXXX:YYYY
  3081.  
  3082.         Example:  $XY$ = 0297:0321
  3083.  
  3084.     -----------------------------------------------------------------
  3085.  
  3086.     $XYM$ ... X, Y & button status (format: XXXX:YYYY:LMR)
  3087.  
  3088.     This text variable will be transformed into a combination of the
  3089.     X and Y mouse location, and a status of which mouse buttons are
  3090.     pressed (if any).
  3091.  
  3092.     The format of the returned text is XXXX:YYYY:LMR where XXXX is
  3093.     the X cursor location in the range 0000-9999.  YYYY is the Y
  3094.     cursor location in the range 0000-9999.  Finally, LMR stands for
  3095.     Left/Middle/Right.  If either of these buttons are depressed
  3096.     (clicked), then the corresponding position will contain a 1.  If
  3097.     a button is NOT depressed, then it will contain a 0.
  3098.  
  3099.         Example:  $XYM$ = 0123:0297:110
  3100.  
  3101.     This means that the (X,Y) location of the cursor is (0123,0297),
  3102.     and that the left and middle buttons are depressed, but that the
  3103.     right mouse button is not depressed.
  3104.  
  3105.     -----------------------------------------------------------------
  3106.  
  3107.     $M$ ... Mouse Button Status: LMR (e.g., 101)
  3108.  
  3109.     This text variable will be transformed into a 3-character code
  3110.     representing what the status of each mouse button is.  This
  3111.     variable can work with either 2-button mice, or 3-button mice.
  3112.     In either event, the format of the code is LMR where L = Left,
  3113.     M = Middle (if any), and R = Right.  If any of these buttons are
  3114.     depressed (i.e., clicked), then the code for that button would be
  3115.     a "1".  If the button is not depressed, it is a "0".  So, a value
  3116.     of "100" would mean that the left mouse button is depressed, but
  3117.     none of the others are.
  3118.  
  3119.         Example:  $M$ = 001
  3120.  
  3121.     -----------------------------------------------------------------
  3122.  
  3123.     $MSTAT$ ... Mouse Status (format: YES/NO)
  3124.  
  3125.     This text variable will be transformed into a "YES" if there is
  3126.     a mouse installed on the RIPterm computer.  If no mouse is
  3127.     installed, this variable will contain "NO".
  3128.  
  3129.         Example:  $MSTAT$ = YES
  3130.  
  3131.     ┌───────────────────────┐
  3132.     │ Active Text Variables │
  3133.     └───────────────────────┘
  3134.  
  3135.     These text variables are somewhat different than the other text
  3136.     variables described above.  Rather than send something back to
  3137.     the host, it performs a specific operation, such as toggling the
  3138.     status line.  In this respect, it is considered an ACTIVE TEXT
  3139.     VARIABLE.  It evaluates to a null string (nothing).
  3140.  
  3141.  
  3142.     $SBARON$ ... Turn ON the Status Line
  3143.  
  3144.     This text variable's sole purpose in life is to enable the Status
  3145.     Line.  It evaluates to a null string (nothing).
  3146.  
  3147.     -----------------------------------------------------------------
  3148.  
  3149.     $SBAROFF$ ... Turn OFF the Status Line
  3150.  
  3151.     This text variable's sole purpose in life is to disable the Status
  3152.     Line.  It evaluates to a null string (nothing).
  3153.  
  3154.     -----------------------------------------------------------------
  3155.  
  3156.     $ETW$ ... Erase Text Window
  3157.  
  3158.     This command erases the current text window (much like a clear
  3159.     screen code does).  This command is particularly useful in host
  3160.     commands when you click on a mouse area, and after it is finished
  3161.     clicking, it could erase the text window THEN transmit the
  3162.     remainder of the host command (if any) to the host.
  3163.  
  3164.     -----------------------------------------------------------------
  3165.  
  3166.     $DTW$ ... Disable Text Window
  3167.  
  3168.     This text variable disables the current text window (preventing
  3169.     any received text from showing up on screen).
  3170.  
  3171.     -----------------------------------------------------------------
  3172.  
  3173.     $EGW$ ... Erase Graphics Window
  3174.  
  3175.     This text variable it erases the current graphics window (much
  3176.     like a reset windows command does).  This command is particularly
  3177.     useful in host commands when you click on a mouse area, and after
  3178.     it is finished clicking, it could erase the graphics window THEN
  3179.     transmit the remainder of the host command (if any) to the host.
  3180.  
  3181.     -----------------------------------------------------------------
  3182.  
  3183.     $MKILL$ ... Kill all Mouse Fields currently defined
  3184.  
  3185.     This text variable deletes all currently defined mouse fields
  3186.     exactly like the RIPscrip RIP_KILL_MOUSE_FIELDS command does. The
  3187.     net benefit of this is that when the user clicks on a mouse
  3188.     button, the mouse fields are removed, but the graphics remain on
  3189.     the screen so that the fields could be subsequently re-defined
  3190.     quickly and easily without having to re-transmit an identical
  3191.     menu over again.
  3192.  
  3193.     -----------------------------------------------------------------
  3194.  
  3195.     $BEEP$ ... Beeps the terminal (like a CTRL-G does)
  3196.  
  3197.     This command issues a beep to the terminal, thus producing
  3198.     a CTRL-G sound.
  3199.  
  3200.     -----------------------------------------------------------------
  3201.  
  3202.     $BLIP$ ... Makes a short "blipping" sound
  3203.  
  3204.     This active text variable is much like the BEEP variable, except
  3205.     that the sound produced is different.  It produces a sound more
  3206.     akin to a "barrier" sound; something that sounds like you're
  3207.     bumping into a wall or something to that effect.
  3208.  
  3209.     -----------------------------------------------------------------
  3210.  
  3211.     $MUSIC$ ... Makes a musical (cheerful) sound
  3212.  
  3213.     This active text variable also produces an audio result.  The
  3214.     sound that is generated is a cheerful sound, representing some
  3215.     kind of success.  The sound is exactly the same as the sound you
  3216.     would hear when you receive a successful download, or when you
  3217.     achieve a connection when dialing the modem in RIPterm.
  3218.  
  3219.     -----------------------------------------------------------------
  3220.  
  3221.     $PCB$ ... Paste Clip Board at last location
  3222.  
  3223.     This command pastes the contents of the clipboard at the last
  3224.     location where the clipboard was "clipped" from.  This even works
  3225.     with icons that are loaded.  The last location taken in this
  3226.     situation, is the location the icon was stamped when it was
  3227.     originally loaded.  This text variable is very useful in
  3228.     situations where you want to "pop-up" a dialog box on the screen
  3229.     (saving the previous area behind the dialog onto the clipboard),
  3230.     and when the user clicks on the "OK" button, restoring the screen
  3231.     contents (by adding a $PCB$ in the host command string).
  3232.  
  3233.     -----------------------------------------------------------------
  3234.  
  3235.     $SMF$ ... Save Mouse Fields
  3236.  
  3237.     This text variable will save all currently defined mouse fields
  3238.     and mouse buttons to a temporary file for later retrieval.  This
  3239.     is designed especially for the graphical designer who wishes to
  3240.     pop-up a dialog box on the screen with one or more mouse fields,
  3241.     and when finished, to restore the screen and original mouse
  3242.     fields (if any) so that the user is not left "floating".  This
  3243.     command is intended to be used with the restore mouse fields text
  3244.     variable $RMF$.
  3245.  
  3246.     -----------------------------------------------------------------
  3247.  
  3248.     $RMF$ ... Restore Mouse Fields
  3249.  
  3250.     This text variable restores any previously saved mouse fields
  3251.     saved with the $SMF$ text variable.  You may have only one set of
  3252.     mouse fields saved at any one time.  If there were no mouse
  3253.     fields saved, or if the number of mouse fields that were saved
  3254.     was 0, then no mouse fields will be active.  Any fields that were
  3255.     defined at the time of this command's execution will be erased.
  3256.     Due to technical details, this should be the last piece of text
  3257.     or the last text variable in any mouse host command (or button
  3258.     host command). Having subsequent text variables or host command
  3259.     text after this variable (in a mouse field) can lead to
  3260.     unpredictable and potentially disastrous results.
  3261.  
  3262.     NOTE: You may restore mouse fields more than once if you wish.
  3263.           In other words, if you perform a "Save Mouse Fields"
  3264.           command, you may execute Restore Mouse Fields one or
  3265.           more times after that point.
  3266.  
  3267. ┌────────────────────────────────────────────────────────────────────┐
  3268. │        2.8.2.4 ■ SPECIAL TEXT VARIABLES - LOCAL RIP PLAYBACK       │
  3269. └────────────────────────────────────────────────────────────────────┘
  3270.  
  3271. You can re-play a .RIP file that you have locally on your hard disk
  3272. from a keystroke macro easily.  The format of the variable is
  3273. somewhat different than user variables, or pre-defined text
  3274. variables.  After the initial dollar sign ($), enter the greater-than
  3275. symbol (>) followed by the filename (with or without the .RIP
  3276. extension), then ending in another dollar sign ($).  Several examples
  3277. of this are as follows:
  3278.  
  3279.     $>MYFILE.RIP$
  3280.     $>FILE1$
  3281.     $>FILE1.RIP$$>FILE2.RIP$$FILE3$
  3282.     $>ANSIFILE.ANS$
  3283.  
  3284. Note in the last example, a file extension other than .RIP was used.
  3285. You are not limited to playing back local .RIP files.  In fact, you
  3286. can play-back any file you want.  You could load any simple text
  3287. file, ANSI picture image, or other such thing.  When loaded, the data
  3288. is not sent to the host; it is strictly echoed on your local screen.
  3289. If the file is a .RIP file, it will replay any graphics that were in
  3290. the file and if any Mouse Regions are defined, it will create those
  3291. fields for you as well, thus allowing you to pop-up dialog screens or
  3292. other such things that are not built-in to RIPterm normally.
  3293.  
  3294. Each "local RIP playback" variable you enter will search for the .RIP
  3295. file in the current host's icon directory.  If it cannot find the
  3296. file in that directory, it will check the ICONS\ directory.
  3297.  
  3298. If you have RIPaint, you could conceivably use this mode to place a
  3299. dialog box on your screen allowing you to alter your modems setup
  3300. quickly with your mouse, dial particular phone numbers, display an
  3301. ANSI text file, or other such things.
  3302.  
  3303. ┌────────────────────────────────────────────────────────────────────┐
  3304. │                        2.8.3 ■ POP-UP LISTS                        │
  3305. └────────────────────────────────────────────────────────────────────┘
  3306.  
  3307. In your keystroke macros you can take advantage of a unique feature
  3308. of RIPterm - popup pick-lists.  A popup pick-list is simply a list
  3309. that pops up allowing you to choose from one of several available
  3310. values.  Whichever entry in the list you choose will be inserted into
  3311. your keystroke macro in place of the list definition.
  3312.  
  3313. In order to use popup pick-lists in your keystroke macros, you must
  3314. define the list in the text of your macro.
  3315.  
  3316. A list is created by putting the special list instructions inside of
  3317. two parenthesis (( and )).  The list instructions consist of an
  3318. optional question, followed by one or more entries to put in the
  3319. List.  For example, ((Send E-Mail to?::Sysop,Cosysop,Joe)) says to
  3320. Pop-Up a list asking you "Send E-Mail to?", giving you the choices of
  3321. "Sysop", "Cosysop", and "Joe".
  3322.  
  3323. By default, if you press <ESCAPE> instead of picking an entry in the
  3324. list, then nothing will be inserted into the text of your macro.  You
  3325. can indicate that the user MUST pick an entry by putting an asterisk
  3326. (*) at the beginning of the question.  For example, ((*Send Mail
  3327. to?::Sysop,Joe)).  This would make it so that the User MUST choose
  3328. either SYSOP or JOE.
  3329.  
  3330. In the previous examples, SYSOP, COSYSOP and JOE are the text
  3331. responses that are inserted into your macros.  These commands are
  3332. also the same things that are displayed in the listing.  If you want
  3333. to use something else instead of the "return text", you can.  When
  3334. you enter the list entry, add an @description to the end of it.
  3335.  
  3336.     Example: ((Send Mail To?::Sysop@The Head Honcho,Cosysop,Joe))
  3337.  
  3338. One final feature of popup pick-lists allow you to specify a hotkey
  3339. for each entry in the list.  For example, if you wanted the first
  3340. character of each entry to be highlighted (thus allowing you to
  3341. select that character to activate the entry), simply put a tilde (~)
  3342. or an underline (_) before and after the keystroke.  For example
  3343. "_S_ysop" would highlight the "S" in "Sysop".  You can highlight more
  3344. than one character, but only the first one will be the active
  3345. hotkey.  If you omit the second tilde or underline, then the
  3346. remainder of the description will be highlighted.
  3347.  
  3348. NOTE: If you use a tilde or an underline in the text response command
  3349.       (not the description), then those characters will be
  3350.       automatically inserted into your macro when it gets transmitted
  3351.       to the host.  This is probably not what you would want to do.
  3352.       Bottom line, only use hotkey features on list entries where you
  3353.       specify a description!
  3354.  
  3355. If you do not specify a question, then the list will ask you:
  3356. "Choose one of the following:"
  3357.  
  3358. You may specify up to twenty list entries for any one list.
  3359.  
  3360. Examples:
  3361.  
  3362.     ((Send E-Mail to?::Sysop,Joe,Mike))
  3363.     ((*Send E-Mail to?::Sysop@The Head Honcho,Joe,Mike@My Brother))
  3364.     ((::Sysop@_T_he Head Honcho,Joe,Mike@My _B_rother))
  3365.     ((Sysop,Joe,Mike,George))
  3366.  
  3367. ┌────────────────────────────────────────────────────────────────────┐
  3368. │                    2.9 ■ ASCII UPLOAD SETTINGS                     │
  3369. └────────────────────────────────────────────────────────────────────┘
  3370.  
  3371. When you select the ASCII Upload Settings option, the following
  3372. dialog box will appear on your screen:
  3373.  
  3374.                 ╔════════════════════════════════════╗
  3375.                 ║       ASCII Upload Settings        ║
  3376.                 ╟────────────────────────────────────╢
  3377.                 ║                     ┌────┐         ║
  3378.                 ║          Line Delay │ 10 │         ║
  3379.                 ║                     ├────┤         ║
  3380.                 ║     Character Delay │  0 │         ║
  3381.                 ║                     └────┘         ║
  3382.                 ║    ┌──────────┐    ┌──────────┐    ║
  3383.                 ║    │    OK    │    │  CANCEL  │    ║
  3384.                 ║    └──────────┘    └──────────┘    ║
  3385.                 ╚════════════════════════════════════╝
  3386.  
  3387. The significance of each field is as follows:
  3388.  
  3389. ┌────────────┐
  3390. │ LINE DELAY │
  3391. └────────────┘
  3392.  
  3393. Sometimes when uploading ASCII files to a host, it is necessary to
  3394. pause in between each line so that the host can process the data.  If
  3395. you find that data is becoming lost, or garbled by the host when you
  3396. perform an ASCII upload, you may need to increase the Line Delay
  3397. option for ASCII uploads.  You may specify a time value in 1/10ths
  3398. of a second.  Therefore, if you specify a value of 11, it would be a
  3399. 1.1 second pause in between lines.
  3400.  
  3401. ┌─────────────────┐
  3402. │ CHARACTER DELAY │
  3403. └─────────────────┘
  3404.  
  3405. Under some circumstances, when performing an ASCII upload to a host,
  3406. it is necessary to insert pauses in between each character that is
  3407. sent to the host.  This may be necessary in situations where the host
  3408. must process each character as it is sent, rather than every line of
  3409. text sent.  You may specify a time value in 1/10ths of a second.
  3410. Therefore, if you specify a value of 11, it would be a 1.1 second
  3411. pause in between lines.
  3412.  
  3413. ┌────────────────────────────────────────────────────────────────────┐
  3414. │                        3.0 ■ THINGS TO KNOW                        │
  3415. └────────────────────────────────────────────────────────────────────┘
  3416.  
  3417. RIPterm may have been accompanied by a number of icon files.  If so,
  3418. they must be located in the ICONS\ directory.  We recommend that you
  3419. install RIPterm into a directory called RIPTERM.  The ICONS\
  3420. directory would be located under the terminal directory as in the
  3421. following example: C:\RIPTERM\ICONS.  All icon files end in an
  3422. extension of .ICN, .MSK or .HIC.  If the icons are not located in the
  3423. ICONS\ directory, then RIPterm will not load them when instructed to
  3424. do so.  RIPterm will try to sense if the icons are easily locatable,
  3425. and if so, prompt you to move them to the correct location when you
  3426. run RIPterm.
  3427.  
  3428. ┌────────────────────────────────────────────────────────────────────┐
  3429. │                    3.1 ■ ONLINE DEMONSTRATIONS                     │
  3430. └────────────────────────────────────────────────────────────────────┘
  3431.  
  3432. If you would like to see an example of RIPscrip graphics in action,
  3433. you may log-on to one of the following hosts free of charge:
  3434.  
  3435. ┌──────────────────────────────────────────────────────────────┐
  3436. │ 1. ArenaBBS - 32 lines, Galacticomm "The Major BBS" software │
  3437. │    This is TeleGrafix's Tech Support/Entertainment BBS       │
  3438. └──────────────────────────────────────────────────────────────┘
  3439.  
  3440.     PHONE: (714) 840-3520
  3441.  
  3442.     > Create an account for yourself on the system by
  3443.     > typing "NEW" at the log-on prompt.  Answer the
  3444.     > questionnaire and at the main menu, type "RIP ON".
  3445.     > Press <ENTER> to redisplay the menu & away
  3446.     > you go!  This is a subscription service, but you do
  3447.     > not need to subscribe to see an on-line demonstration.
  3448.     > If you discover that your icon files are out of date,
  3449.     > send E-mail to SYSOP or download the file ARENAICN.ZIP
  3450.     > from the RIPICONS file library section.
  3451.  
  3452. ┌──────────────────────────────────────────────────────────────┐
  3453. │ 2. Nova Central - 4 lines, ResNova "Nova Link Professional"  │
  3454. │    This is ResNova's Technical Support BBS                   │
  3455. └──────────────────────────────────────────────────────────────┘
  3456.  
  3457.     PHONE: (714) 840-8641
  3458.  
  3459.     > This is ResNova's technical support BBS.  It is using
  3460.     > the Nova Link Professional host for the Apple
  3461.     > Macintosh.  Simply sign-up on the system and at the
  3462.     > Main Menu, choose the "RIPscrip Graphics" option
  3463.     > for an on-line demonstration.
  3464.  
  3465. ┌──────────────────────────────────────────────────────────────┐
  3466. │ 3. RIP Demo Midwest - 2 line TBBS system.  This BBS is a     │
  3467. │    full RIP Demo System.                                     │
  3468. └──────────────────────────────────────────────────────────────┘
  3469.  
  3470.     PHONE: (708) 978-2777
  3471.  
  3472.     > Sign-up in "text mode" if you do not have the RDM
  3473.     > icons.  Download the system icons and away you
  3474.     > go.  Be sure to see the Message Forums and other areas.
  3475.  
  3476.  
  3477. ┌────────────────────────────────────────────────────────────────────┐
  3478. │               APPENDIX A ■ TROUBLESHOOTING/PROBLEMS                │
  3479. └────────────────────────────────────────────────────────────────────┘
  3480.  
  3481. Modem communications is not a simple thing.  There are many different
  3482. technical factors that can affect RIPterm, making it work
  3483. erratically, or unreliably.  This section is intended to try to help
  3484. you figure out what's wrong and get yourself up and running as
  3485. quickly as possible.
  3486.  
  3487. Check through the remainder of this section to see if the particular
  3488. problem you're having is addressed.  If you are having some sort of
  3489. difficulty not covered below (or the instructions that follow do not
  3490. resolve the problem), contact the TeleGrafix Technical Support
  3491. department as noted in APPENDIX B.
  3492.  
  3493. ┌────────────────────────────────────────────────────────────────────┐
  3494. │                   A.1 ■ "BUS" MOUSE DOESN'T WORK                   │
  3495. └────────────────────────────────────────────────────────────────────┘
  3496.  
  3497. Make sure your mouse driver is loaded into memory before you run
  3498. RIPterm.  Without a mouse driver loaded, RIPterm will not be able to
  3499. use your mouse.  Consult the manual that came with your mouse under
  3500. the section INSTALLATION or SOFTWARE INSTALLATION.
  3501.  
  3502. Most mouse drivers come in two flavors, a .SYS file, or a TSR program
  3503. ending in a .COM file extension.  A .SYS file must be loaded into
  3504. your C:\CONFIG.SYS file as any other device driver.
  3505.  
  3506. An example of loading your MOUSE.SYS driver would be as follows:
  3507.  
  3508.  
  3509.     CONFIG.SYS file:
  3510.  
  3511.         FILES=40
  3512.         BUFFERS=40
  3513.         DEVICE=C:\MOUSE\MOUSE.SYS
  3514.  
  3515. If your mouse came only with a MOUSE.COM driver, then you must edit
  3516. your C:\AUTOEXEC.BAT file and add a line calling mouse driver so that
  3517. it can be loaded into memory each time your system boots up.  Add a
  3518. line similar to the one that follows:
  3519.  
  3520.     AUTOEXEC.BAT file:
  3521.  
  3522.         PATH=C:\;C:\DOS;C:\MOUSE
  3523.         PROMPT $P$G
  3524.         MOUSE
  3525.  
  3526. Modifications may vary - consult your Mouse Manual.
  3527.  
  3528. ┌────────────────────────────────────────────────────────────────────┐
  3529. │                 A.2 ■ "SERIAL" MOUSE DOESN'T WORK                  │
  3530. └────────────────────────────────────────────────────────────────────┘
  3531.  
  3532. If you are using a serial mouse, and it is not responding, you might
  3533. be experiencing a "conflict" between your modem serial port, and your
  3534. mouse serial port.  Under most circumstances, a conflict like this
  3535. will NOT arise in normal applications programs that don't use both a
  3536. mouse and a modem simultaneously.
  3537.  
  3538. Below you should find a list of correct and incorrect modem/mouse
  3539. configurations.
  3540.  
  3541.     CORRECT COMBINATIONS        INCORRECT COMBINATIONS
  3542.     =======================     =======================
  3543.     Modem=COM1 / Mouse=COM2     Modem=COM1 / Mouse=COM3
  3544.     Modem=COM1 / Mouse=COM4     Modem=COM2 / Mouse=COM4
  3545.     Modem=COM2 / Mouse=COM1     Modem=COM3 / Mouse=COM1
  3546.     Modem=COM2 / Mouse=COM3     Modem=COM4 / Mouse=COM2
  3547.     Modem=COM3 / Mouse=COM2
  3548.     Modem=COM3 / Mouse=COM4
  3549.     Modem=COM4 / Mouse=COM1
  3550.     Modem=COM4 / Mouse=COM3
  3551.  
  3552. If you are knowledgeable about IBM-PC hardware, and how to install
  3553. add-on cards, you may be able to circumvent the above recommended
  3554. port combinations.  To do this will require removing the PC cover and
  3555. changing the interrupt (IRQ) setting of either the modem serial port,
  3556. or the mouse serial port (if possible).  In order to get both the
  3557. mouse and the modem operating properly, the two serial ports must use
  3558. different IRQ settings!  If none of this makes sense to you, we would
  3559. recommend sticking to the above recommended layouts.
  3560.  
  3561. ┌────────────────────────────────────────────────────────────────────┐
  3562. │                    A.3 ■ MODEM ISN'T RESPONDING                    │
  3563. └────────────────────────────────────────────────────────────────────┘
  3564.  
  3565. If you have a serial mouse, you may be experiencing a conflict
  3566. between your mouse and your modem.  A serial mouse can be identified
  3567. if it plugs into one of your IBM-PC communications ports COM1 through
  3568. COM4.  Not all systems have 4 COM ports, so your system may be
  3569. somewhat different.  A serial mouse typically has a 25-pin connector
  3570. shaped like an elongated "D".  Another type of serial mouse has a
  3571. 9-pin connector also shaped like a "D".
  3572.  
  3573. Check to make sure you modem is plugged in and turned on (if it is an
  3574. external modem).  Make sure that the serial cable connecting the
  3575. modem to your computer is securely fastened to the proper COM port.
  3576.  
  3577. Check your modem settings to make sure they are set correctly.  You
  3578. may edit these settings by pressing ALT-O (Modem Options).  Things
  3579. you should check for:
  3580.  
  3581.     1.  Make sure it is set for the correct port (COM1 - COM4)
  3582.  
  3583.     2.  Make sure the baud rate is set to a speed your modem
  3584.         can support (or lower).  Settings for this would be
  3585.         300, 1200, 2400, 9600, 19,200 baud.
  3586.  
  3587. Consult SECTION 4.1 above to determine if you are using an
  3588. incorrect COM port configuration for your serial mouse and your
  3589. modem.
  3590.  
  3591. ┌────────────────────────────────────────────────────────────────────┐
  3592. │                 A.4 ■ NOISY TELEPHONE CONNECTIONS                  │
  3593. └────────────────────────────────────────────────────────────────────┘
  3594.  
  3595. If you get a noisy telephone connection, the graphics that you see
  3596. might become garbled in some fashion.  Since RIPterm does more than
  3597. simply display pictures on the screen, this can disturb underlying
  3598. (invisible) operations as well.
  3599.  
  3600. Solutions:  Hang-up and try calling again.  Often times, this can
  3601.             resolve the problem.
  3602.  
  3603.             Long distance connections are typically the noisiest
  3604.             connections.  Check with your operator and find out if
  3605.             you can use a different "Long Distance Carrier" like MCI,
  3606.             AT&T, US Sprint, etc.
  3607.  
  3608.             Use an Error-Correcting modem (provided the host you are
  3609.             calling can support one).
  3610.  
  3611. ┌────────────────────────────────────────────────────────────────────┐
  3612. │                   APPENDIX B ■ TECHNICAL SUPPORT                   │
  3613. └────────────────────────────────────────────────────────────────────┘
  3614.  
  3615. This program is as bug-free as possible.  In all reality, there are
  3616. most likely some bugs that have not as of yet been discovered.
  3617. Should any bugs be discovered, they should be reported to the authors
  3618. as soon as possible at the following address:
  3619.  
  3620.           ┌───────────────────────────────────────────────┐
  3621.           │        TeleGrafix Communications, Inc.        │
  3622.           │            16458 Bolsa Chica #15              │
  3623.           │          Huntington Beach, CA 92649           │
  3624.           │                                               │
  3625.           │ Voice .. (714) 846-4179                       │
  3626.           │ Fax .... (714) 846-4189                       │
  3627.           │ Data ... (714) 840-3520 - ArenaBBS [32 lines] │
  3628.           └───────────────────────────────────────────────┘
  3629.  
  3630.    Authors: Jeff "Covenant" Reeder
  3631.             (CEO: Senior Programmer)
  3632.  
  3633.             Mark "Necron" Hayton
  3634.             (President: Programmer)
  3635.  
  3636.             Jim "Bergie" Bergman
  3637.             (Vice President: Programmer)
  3638.  
  3639.             Mara "Kytty" Ward
  3640.             (Chief Operations Officer: Production)
  3641.  
  3642. ┌────────────────────────────────────────────────────────────────────┐
  3643. │                   APPENDIX C ■ RIPscrip Products                   │
  3644. └────────────────────────────────────────────────────────────────────┘
  3645.  
  3646. For more information about RIPscrip based products, contact:
  3647.  
  3648.     TeleGrafix Communications, Inc.
  3649.     16458 Bolsa Chica, #15
  3650.     Huntington Beach, CA 92649
  3651.  
  3652.     Voice: (714) 846-4179
  3653.     Fax  : (714) 846-4189
  3654.     Data : (714) 840-3520 ArenaBBS [32 lines] running The Major BBS
  3655.